<!DOCTYPE html><html lang="en"><head>
<title> 企业云盘API接口文档---小书匠,在线编辑器,MARKDOWN,Evernote,文件版本</title>
  <meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="()">
<link rel="stylesheet" href="http://maxcdn.bootstrapcdn.com/font-awesome/4.3.0/css/font-awesome.min.css">
<style type="text/css">

</style>
</head><body>
<div><div class="preview" id="wmd-preview">
<style>
a:focus {
	outline:	thin dotted #333;
	outline:	5px auto -webkit-focus-ring-color;
	outline-offset:	-2px;
}
a:hover {
	outline:	0;
}
a:active {
	outline:	0;
}
a:hover {
	color:	#005580 !important;
	text-decoration:	underline !important;
}
blockquote   small:before {
	content:	'\2014 \00A0';
}
q:before {
	content:	"";
}
q:after {
	content:	"";
}
blockquote:before {
	content:	"";
}
blockquote:after {
	content:	"";
}
.hljs-folder:before {
	top:	0;
	content:	'';
	width:	14px;
	height:	12px;
	margin-top:	0px;
	margin-right:	3px;
	position:	relative;
	display:	inline-block;
	background-size:	14px;
	background-repeat:	no-repeat;
}
.hljs-file:before {
	top:	0;
	content:	'';
	width:	14px;
	height:	12px;
	margin-top:	0px;
	margin-right:	3px;
	position:	relative;
	display:	inline-block;
	background-size:	14px;
	background-repeat:	no-repeat;
}
.hljs-hiddenfile:before {
	top:	0;
	content:	'';
	width:	14px;
	height:	12px;
	margin-top:	0px;
	margin-right:	3px;
	position:	relative;
	display:	inline-block;
	background-size:	14px;
	background-repeat:	no-repeat;
}
.hljs-file:before {
	height:	14px;
	margin-left:	1px;
}
.hljs-hiddenfile:before {
	height:	14px;
	margin-left:	1px;
}
.hljs-file.photo:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f1c5";
}
.hljs-file.plain:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f016";
}
.hljs-file.source:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f1c9";
}
.hljs-file.archive:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f1c6";
}
.hljs-file.audio:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f1c7";
}
.hljs-file.video:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f1c8";
}
.hljs-file.pdf:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f1c1";
}
.hljs-file.xls:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f1c3";
}
.hljs-file.doc:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f1c2";
}
.hljs-file.ppt:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f1c4";
}
.hljs-folder:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f114";
}
.hljs-hiddenfile:before {
	font:	normal normal normal 14px / 1 FontAwesome;
	content:	"\f016";
}
li.li_linenum:before {
	content:	counter(lines , decimal);
	position:	absolute;
	left:	0px;
	text-align:	center;
	width:	2.5em;
	opacity:	0.5;
	vertical-align:	top;
}

</style><body style="font-family: Helvetica , Tahoma , Arial , STXihei , &quot;&#x534E;&#x6587;&#x7EC6;&#x9ED1;&quot; , &quot;Microsoft YaHei&quot; , &quot;&#x5FAE;&#x8F6F;&#x96C5;&#x9ED1;&quot; , Heiti , &quot;&#x9ED1;&#x4F53;&quot; , SimSun , &quot;&#x5B8B;&#x4F53;&quot; , sans-serif; font-size: 1.15em; font-weight: 100; color: #2f2f2f;">
	<div class="preview"><h1 class="story_title" style="margin-top: 1em; margin-right: 0; margin-bottom: 1em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.6; color: inherit; text-rendering: optimizelegibility; font-size: 38.5px;">企业云盘API接口文档</h1><div class="story_tags"><div class="tag blue label" style="display: inline-block; vertical-align: baseline; line-height: 1; margin-top: 0em; margin-right: 0.125em; margin-bottom: 0em; margin-left: 0.125em; background-color: #3b83c0 !important; border-color: #3b83c0 !important; background-image: none; padding-top: 0.6em; padding-right: 0.8em; padding-bottom: 0.6em; padding-left: 0.8em; color: #ffffff !important; text-transform: none; font-weight: bold; border-radius: 0.2857rem; box-sizing: border-box; font-size: 0.7428rem;">书生云</div><div class="tag blue label" style="display: inline-block; vertical-align: baseline; line-height: 1; margin-top: 0em; margin-right: 0.125em; margin-bottom: 0em; margin-left: 0.125em; background-color: #3b83c0 !important; border-color: #3b83c0 !important; background-image: none; padding-top: 0.6em; padding-right: 0.8em; padding-bottom: 0.6em; padding-left: 0.8em; color: #ffffff !important; text-transform: none; font-weight: bold; border-radius: 0.2857rem; box-sizing: border-box; font-size: 0.7428rem;">企业云盘</div><div class="tag blue label" style="display: inline-block; vertical-align: baseline; line-height: 1; margin-top: 0em; margin-right: 0.125em; margin-bottom: 0em; margin-left: 0.125em; background-color: #3b83c0 !important; border-color: #3b83c0 !important; background-image: none; padding-top: 0.6em; padding-right: 0.8em; padding-bottom: 0.6em; padding-left: 0.8em; color: #ffffff !important; text-transform: none; font-weight: bold; border-radius: 0.2857rem; box-sizing: border-box; font-size: 0.7428rem;">API</div><div class="tag blue label" style="display: inline-block; vertical-align: baseline; line-height: 1; margin-top: 0em; margin-right: 0.125em; margin-bottom: 0em; margin-left: 0.125em; background-color: #3b83c0 !important; border-color: #3b83c0 !important; background-image: none; padding-top: 0.6em; padding-right: 0.8em; padding-bottom: 0.6em; padding-left: 0.8em; color: #ffffff !important; text-transform: none; font-weight: bold; border-radius: 0.2857rem; box-sizing: border-box; font-size: 0.7428rem;">RESTful</div><div class="tag blue label" style="display: inline-block; vertical-align: baseline; line-height: 1; margin-top: 0em; margin-right: 0.125em; margin-bottom: 0em; margin-left: 0.125em; background-color: #3b83c0 !important; border-color: #3b83c0 !important; background-image: none; padding-top: 0.6em; padding-right: 0.8em; padding-bottom: 0.6em; padding-left: 0.8em; color: #ffffff !important; text-transform: none; font-weight: bold; border-radius: 0.2857rem; box-sizing: border-box; font-size: 0.7428rem;">接口</div></div><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">本文档适用于利用企业云盘进行二次开发及系统集成等工作</p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"></p><div class="toc">
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li style="list-style: none;"><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e6b3a8e6848fe4ba8be9a1b9" data-line="-1" style="color: #0088cc; text-decoration: none;">注意事项</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#120e697a5e69c9fe6a0bce5bc8f" data-line="-1" style="color: #0088cc; text-decoration: none;">1. 日期格式</a></li>
<li style="list-style: none;"><a href="#220utf-820e7bc96e7a081" data-line="-1" style="color: #0088cc; text-decoration: none;">2. UTF-8 编码</a></li>
<li style="list-style: none;"><a href="#320e585b3e4ba8ee8b083e794a8e7a4bae4be8b" data-line="-1" style="color: #0088cc; text-decoration: none;">3. 关于调用示例</a></li>
<li style="list-style: none;"><a href="#420e8be93e585a5e8be93e587ba20e6a0bce5bc8f" data-line="-1" style="color: #0088cc; text-decoration: none;">4. 输入/输出 格式</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e99499e8afafe5a484e79086" data-line="-1" style="color: #0088cc; text-decoration: none;">错误处理</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e6a087e58786apie99499e8afaf" data-line="-1" style="color: #0088cc; text-decoration: none;">标准API错误</a></li>
<li style="list-style: none;"><a href="#e99499e8afafe4bfa1e681afe7a4bae4be8b" data-line="-1" style="color: #0088cc; text-decoration: none;">错误信息示例</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#rest20api20url" data-line="-1" style="color: #0088cc; text-decoration: none;">Rest API URL</a></li>
<li style="list-style: none;"><a href="#e799bbe5bd95e58f8ae88eb7e58f96token" data-line="-1" style="color: #0088cc; text-decoration: none;">登录及获取token</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#method" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
</ul>
</li>
</ul>
</li>
<li style="list-style: none;"><a href="#e79baee5bd95" data-line="-1" style="color: #0088cc; text-decoration: none;">目录</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e79baee5bd95e5afb9e8b1a1" data-line="-1" style="color: #0088cc; text-decoration: none;">目录对象</a></li>
<li style="list-style: none;"><a href="#e88eb7e58f96e79baee5bd95e58583e695b0e68dae" data-line="-1" style="color: #0088cc; text-decoration: none;">获取目录元数据</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-1" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-1" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-1" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-1" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-1" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e88eb7e58f96e68c87e5ae9ae79baee5bd95e4b88be68980e69c89e58685e5aeb9" data-line="-1" style="color: #0088cc; text-decoration: none;">获取指定目录下所有内容</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-2" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-2" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-2" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-2" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-2" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-1" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e5889be5bbbae4b880e4b8aae79baee5bd95" data-line="-1" style="color: #0088cc; text-decoration: none;">创建一个目录</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-3" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-3" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-3" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-3" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-3" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-2" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e588a0e999a4e79baee5bd95" data-line="-1" style="color: #0088cc; text-decoration: none;">删除目录</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-4" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-4" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-4" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-4" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-4" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-3" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e7a7bbe58aa8e79baee5bd95" data-line="-1" style="color: #0088cc; text-decoration: none;">移动目录</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-5" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-5" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-5" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-5" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body-1" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-5" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-4" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e69bb4e696b0e4b880e4b8aae79baee5bd95" data-line="-1" style="color: #0088cc; text-decoration: none;">更新一个目录</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-6" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-6" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-6" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-6" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body-2" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-6" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-5" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e88eb7e58f96e68c87e5ae9ae79baee5bd95e79a84e585a8e8b7afe5be84" data-line="-1" style="color: #0088cc; text-decoration: none;">获取指定目录的全路径</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-7" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-7" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-7" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-7" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-7" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-6" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
</ul>
</li>
<li style="list-style: none;"><a href="#e69687e4bbb6" data-line="-1" style="color: #0088cc; text-decoration: none;">文件</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e69687e4bbb6e5afb9e8b1a1" data-line="-1" style="color: #0088cc; text-decoration: none;">文件对象</a></li>
<li style="list-style: none;"><a href="#e4b88ae4bca0e4b880e4b8aae69687e4bbb6" data-line="-1" style="color: #0088cc; text-decoration: none;">上传一个文件</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-8" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-8" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#e8a1a8e58d95e58583e7b4a0" data-line="-1" style="color: #0088cc; text-decoration: none;">表单元素</a></li>
<li style="list-style: none;"><a href="#cookie" data-line="-1" style="color: #0088cc; text-decoration: none;">Cookie</a></li>
<li style="list-style: none;"><a href="#method-8" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-8" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-8" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-7" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e4b88be8bdbde69687e4bbb6" data-line="-1" style="color: #0088cc; text-decoration: none;">下载文件</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-9" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-9" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-9" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-9" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-9" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-8" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e88eb7e58f96e69687e4bbb6e58583e695b0e68dae" data-line="-1" style="color: #0088cc; text-decoration: none;">获取文件元数据</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-10" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-10" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-10" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-10" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-10" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-9" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e7a7bbe58aa8e69687e4bbb6" data-line="-1" style="color: #0088cc; text-decoration: none;">移动文件</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-11" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-11" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-11" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-11" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body-3" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-11" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-10" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e5a48de588b6e69687e4bbb6" data-line="-1" style="color: #0088cc; text-decoration: none;">复制文件</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-12" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-12" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-12" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-12" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body-4" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-12" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-11" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e588a0e999a4e69687e4bbb6" data-line="-1" style="color: #0088cc; text-decoration: none;">删除文件</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-13" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-13" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-13" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-13" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-13" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-12" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e4bfaee694b9e69687e4bbb6e58583e695b0e68dae" data-line="-1" style="color: #0088cc; text-decoration: none;">修改文件元数据</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-14" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-14" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-14" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-14" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body-5" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-14" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-13" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
</ul>
</li>
<li style="list-style: none;"><a href="#e5a29ee9878fe69bb4e696b0e79bb8e585b3api" data-line="-1" style="color: #0088cc; text-decoration: none;">增量更新相关API</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e88eb7e58f96e794a8e688b7e7a9bae997b4e4bfa1e681af" data-line="-1" style="color: #0088cc; text-decoration: none;">获取用户空间信息</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-15" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-15" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-15" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-15" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-15" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e794a8e688b7e6a0b9e79baee5bd95e69c80e5908ee4bfaee694b9e697b6e997b4" data-line="-1" style="color: #0088cc; text-decoration: none;">用户根目录最后修改时间</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-16" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-16" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-16" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-16" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-16" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e79baee5bd95e5a29ee9878fe69bb4e696b0e69fa5e8afa2" data-line="-1" style="color: #0088cc; text-decoration: none;">目录增量更新查询</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-17" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-17" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-17" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-17" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-17" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e69687e4bbb6e5a29ee9878fe69bb4e696b0e69fa5e8afa2" data-line="-1" style="color: #0088cc; text-decoration: none;">文件增量更新查询</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-18" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-18" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-18" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-18" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-18" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
</ul>
</li>
</ul>
</li>
<li style="list-style: none;"><a href="#surdoce5ae89e585a8e4b88ae4bca0e68ea5e58fa3api" data-line="-1" style="color: #0088cc; text-decoration: none;">Surdoc安全上传接口API</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e6a0b9e68daee69198e8a681e588a4e696ade69687e4bbb6e698afe590a6e5b7b2e7bb8fe5ad98e59ca8efbc88e69687e4bbb6e58ebbe9878de588a4e696adefbc89" data-line="-1" style="color: #0088cc; text-decoration: none;">根据摘要判断文件是否已经存在（文件去重判断）</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-19" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-19" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-19" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-19" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-19" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-14" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e7a792e4bca0" data-line="-1" style="color: #0088cc; text-decoration: none;">秒传</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-20" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-20" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#e8a1a8e58d95e58583e7b4a0-1" data-line="-1" style="color: #0088cc; text-decoration: none;">表单元素</a></li>
<li style="list-style: none;"><a href="#method-20" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-20" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-20" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-15" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e99d9ee5a4a7e69687e4bbb6e4b88ae4bca0" data-line="-1" style="color: #0088cc; text-decoration: none;">非大文件上传</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-21" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-21" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#e8a1a8e58d95e58583e7b4a0-2" data-line="-1" style="color: #0088cc; text-decoration: none;">表单元素</a></li>
<li style="list-style: none;"><a href="#method-21" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-21" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-21" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-16" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e5a4a7e69687e4bbb6e79a84e4b88ae4bca0e4b88ee7bbade4bca0" data-line="-1" style="color: #0088cc; text-decoration: none;">大文件的上传与续传</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#1e794b3e8afb7e4b88ae4bca0e59cb0e59d80" data-line="-1" style="color: #0088cc; text-decoration: none;">1.申请上传地址</a></li>
<li style="list-style: none;"><a href="#e68f8fe8bfb0-22" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-22" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-22" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-22" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-22" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#2e4b88ae4bca0e69687e4bbb6" data-line="-1" style="color: #0088cc; text-decoration: none;">2.上传文件</a></li>
<li style="list-style: none;"><a href="#e68f8fe8bfb0-23" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-23" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#curl-23" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-23" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-17" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
<li style="list-style: none;"><a href="#3e7bba7e7bbade4b8ade696ade79a84e4b88ae4bca0" data-line="-1" style="color: #0088cc; text-decoration: none;">3.继续中断的上传</a></li>
<li style="list-style: none;"><a href="#3120e88eb7e58f96e69687e4bbb6e5b7b2e4b88ae4bca0e588b0e69c8de58aa1e599a8e79a84e5ad97e88a82e695b0" data-line="-1" style="color: #0088cc; text-decoration: none;">3.1 获取文件已上传到服务器的字节数</a></li>
<li style="list-style: none;"><a href="#3220e7bba7e7bbade4b88ae4bca0e4bd99e4b88be79a84e69687e4bbb6e5ad97e88a82e695b0e68dae" data-line="-1" style="color: #0088cc; text-decoration: none;">3.2 继续上传余下的文件字节数据</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e4b88be8bdbde5af86e69687e69687e4bbb6" data-line="-1" style="color: #0088cc; text-decoration: none;">下载密文文件</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-24" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-24" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-23" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-24" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-24" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-18" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
</ul>
</li>
<li style="list-style: none;"><a href="#e78988e69cace68ea7e588b6e79bb8e585b3e68ea5e58fa3efbc88e4b8aae4babaefbc89" data-line="-1" style="color: #0088cc; text-decoration: none;">版本控制相关接口（个人）</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e88eb7e58f96e78988e69cace58897e8a1a8" data-line="-1" style="color: #0088cc; text-decoration: none;">获取版本列表</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-25" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-25" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-24" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-25" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-25" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-19" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e4baa4e68da2e78988e69cac" data-line="-1" style="color: #0088cc; text-decoration: none;">交换版本</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-26" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-26" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-25" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-26" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-26" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-20" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e4b88be8bdbde69f90e4b8aae78988e69cac" data-line="-1" style="color: #0088cc; text-decoration: none;">下载某个版本</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-27" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-27" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-26" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-27" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-27" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-21" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
</ul>
</li>
<li style="list-style: none;"><a href="#e78988e69cace68ea7e588b6e79bb8e585b3e68ea5e58fa3efbc88e585b1e4baabe69687e4bbb6e5a4b9efbc89" data-line="-1" style="color: #0088cc; text-decoration: none;">版本控制相关接口（共享文件夹）</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e88eb7e58f96e78988e69cace58897e8a1a8-1" data-line="-1" style="color: #0088cc; text-decoration: none;">获取版本列表</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-28" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-28" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-27" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-28" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-28" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-22" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e4baa4e68da2e78988e69cac-1" data-line="-1" style="color: #0088cc; text-decoration: none;">交换版本</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-29" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-29" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-28" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-29" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-29" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-23" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e4b88be8bdbde69f90e4b8aae78988e69cac-1" data-line="-1" style="color: #0088cc; text-decoration: none;">下载某个版本</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-30" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-30" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-29" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-30" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-30" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-24" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
</ul>
</li>
<li style="list-style: none;"><a href="#e585b1e4baabe79baee5bd95e79bb8e585b3e68ea5e58fa3" data-line="-1" style="color: #0088cc; text-decoration: none;">共享目录相关接口</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e88eb7e58f96e585b1e4baabe69687e4bbb6e5a4b9" data-line="-1" style="color: #0088cc; text-decoration: none;">获取共享文件夹</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-31" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-31" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-30" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-31" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-31" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e7a7bbe58aa8e69687e4bbb6e887b3e585b1e4baabe79baee5bd95" data-line="-1" style="color: #0088cc; text-decoration: none;">移动文件至共享目录</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-32" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-32" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-31" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-32" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body-6" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-32" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-25" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e5a48de588b6e69687e4bbb6e887b3e585b1e4baabe79baee5bd95" data-line="-1" style="color: #0088cc; text-decoration: none;">复制文件至共享目录</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-33" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-33" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-32" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-33" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body-7" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-33" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-26" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
</ul>
</li>
<li style="list-style: none;"><a href="#e58886e4baabe993bee68ea5e79bb8e585b3e68ea5e58fa3" data-line="-1" style="color: #0088cc; text-decoration: none;">分享链接相关接口</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e4bf9de5ad98e69687e4bbb6e79a84e58886e4baabe993bee68ea5e4bfa1e681afe887b3e69c8de58aa1e7abaf" data-line="-1" style="color: #0088cc; text-decoration: none;">保存文件的分享链接信息至服务端</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-34" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-34" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-33" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-34" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body-8" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-34" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-27" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e4bf9de5ad98e585b1e4baabe79baee5bd95e4b8ade69687e4bbb6e79a84e58886e4baabe993bee68ea5e4bfa1e681afe887b3e69c8de58aa1e7abaf" data-line="-1" style="color: #0088cc; text-decoration: none;">保存共享目录中文件的分享链接信息至服务端</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-35" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-35" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-34" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-35" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body-9" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-35" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
<li style="list-style: none;"><a href="#e99499e8afaf-28" data-line="-1" style="color: #0088cc; text-decoration: none;">错误</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e58886e4baabe993bee68ea5e8aebee7bdae" data-line="-1" style="color: #0088cc; text-decoration: none;">分享链接设置</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-36" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-36" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-35" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-36" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body-10" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-36" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
</ul>
</li>
<li style="list-style: none;"><a href="#e58f91e98081e58886e4baabe993bee68ea5e79a84e982aee4bbb6" data-line="-1" style="color: #0088cc; text-decoration: none;">发送分享链接的邮件</a><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li style="list-style: none;"><a href="#e68f8fe8bfb0-37" data-line="-1" style="color: #0088cc; text-decoration: none;">描述</a></li>
<li style="list-style: none;"><a href="#urle7bb93e69e84-37" data-line="-1" style="color: #0088cc; text-decoration: none;">URL结构</a></li>
<li style="list-style: none;"><a href="#method-36" data-line="-1" style="color: #0088cc; text-decoration: none;">METHOD</a></li>
<li style="list-style: none;"><a href="#curl-37" data-line="-1" style="color: #0088cc; text-decoration: none;">curl</a></li>
<li style="list-style: none;"><a href="#request20body-11" data-line="-1" style="color: #0088cc; text-decoration: none;">Request Body</a></li>
<li style="list-style: none;"><a href="#e8bf94e59b9e-37" data-line="-1" style="color: #0088cc; text-decoration: none;">返回</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"></p>
<h2 id="e6b3a8e6848fe4ba8be9a1b9" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:notes" target="_blank" style="color: #0088cc; text-decoration: none;">注意事项</a></h2>
<h3 id="120e697a5e69c9fe6a0bce5bc8f" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;">1. 日期格式</h3>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">API中所有的日期都是 <a href="http://en.wikipedia.org/wiki/ISO_8601" title="ISO8601" target="_blank" style="color: #0088cc; text-decoration: none;">ISO8601</a> 的格式:</p>
<pre style="word-wrap: break-word;"><code class="hljs css" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">"2013<span class="hljs-tag" style="color: #ef6155;">-05-13T02</span><span class="hljs-pseudo" style="color: #ef6155;">:48</span><span class="hljs-pseudo" style="color: #ef6155;">:13</span><span class="hljs-class" style="color: #ef6155;">.934Z</span>"
</code></pre>
<h3 id="220utf-820e7bc96e7a081" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;">2. UTF-8 编码</h3>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">所有通过企业云盘API传送的字符，均为UTF-8编码。</p>
<h3 id="320e585b3e4ba8ee8b083e794a8e7a4bae4be8b" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;">3. 关于调用示例</h3>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">每个API调用示例都提供<a href="http://curl.haxx.se/" target="_blank" style="color: #0088cc; text-decoration: none;">cURL</a>的方式，你只需要填写其中必要的参数即可在命令行测试API调用。<a href="https://httpkit.com/resources/HTTP-from-the-Command-Line/" target="_blank" style="color: #0088cc; text-decoration: none;">这是用cURL调用API的教程</a>。如果你不熟悉命令行，也可以使用这个很棒的Chrome浏览器扩展，<a href="https://chrome.google.com/webstore/detail/fdmmgilgnpjigdojojpjoooidkmcomcm" target="_blank" style="color: #0088cc; text-decoration: none;">POSTMAN</a>。</p>
<h3 id="420e8be93e585a5e8be93e587ba20e6a0bce5bc8f" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;">4. 输入/输出 格式</h3>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">request body 数据与 response 数据，均为 <a href="http://www.json.org/" target="_blank" style="color: #0088cc; text-decoration: none;">JSON</a>格式。</p>
<h2 id="e99499e8afafe5a484e79086" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:errors" target="_blank" style="color: #0088cc; text-decoration: none;">错误处理</a></h2>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">使用标准 HTTP 状态码来返回错误。更多的详细信息在调用的返回内容中，以JSON格式返回。</p>
<h3 id="e6a087e58786apie99499e8afaf" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;">标准API错误</h3>
<table class="table table-striped  " style="max-width: 100%; background-color: transparent; border-collapse: collapse; border-spacing: 0; width: 100%; margin-bottom: 20px;">
<thead>
<tr>
<th style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: bottom; border-top: 0; font-weight: bold;">HTTP状态码</th>
<th style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: bottom; border-top: 0; font-weight: bold;">错误码</th>
<th style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: bottom; border-top: 0; font-weight: bold;">备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">400</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10011</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">错误的输入参数，错误信息会标明哪一个参数</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">401</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">10010</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">错误或者过期的Token。 当Token被用户或者SurDoc撤销或者过期，会出现此错误。 应该引导用户重新进行授权操作。</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">403</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10060</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">访问权限错误，比如用户访问一个不属于他的文件</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">403</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">10061</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">访问权限错误，目录禁止访问</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">403</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10062</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">访问权限错误，文件禁止访问</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">404</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">10020</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">在指定的位置不存在需要的文件或目录</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">404</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10021</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">在指定的位置不存在需要的目录</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">404</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">10022</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">在指定的位置不存在需要的文件</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">404</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10023</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">文件摘要不存在，请使用上传接口上传完整文件</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">409</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">10030</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">指定位置存在同名的文件或目录</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">409</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10031</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">指定位置存在同名的目录</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">409</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">10032</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">指定位置存在同名的文件</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">304</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10033</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">资源没有被修改，包括目录与文件</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">304</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">10034</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">目录没有被修改</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">304</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10035</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">文件没有被修改</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">405</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;"></td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">不期望的Request method</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">507</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10071</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">用户空间已满</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">507</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">10072</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">用户非文档空间已满</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">507</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10073</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">一个非文档文件的大小超过用户账号类型允许的大小</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">503</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">10000</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">未知的I/O错误</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">503</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10001</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">网络错误</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">503</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">10080</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">文件上传错误</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">503</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">10090</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">服务器存储读写错误</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">503</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">10091</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">数据库读写错误</td>
</tr>
</tbody>
</table>
<h3 id="e99499e8afafe4bfa1e681afe7a4bae4be8b" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;">错误信息示例</h3>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">status</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">404</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">code</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">404</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">errorCode</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">10022</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">message</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"File not found"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">moreInfoUrl</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"mailto:developers@surdoc.com"</span>
</span>}
</code></pre>
<h2 id="rest20api20url" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:api_url" target="_blank" style="color: #0088cc; text-decoration: none;">Rest API URL</a></h2>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">与Access Token一起返回的<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">resource_server</code>是API URL的基准路径，以<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">/</code>结尾。</p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">示例:</p>
<pre style="word-wrap: break-word;"><code class="hljs vim" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">http<span class="hljs-variable" style="color: #ef6155;">s:</span>//<span class="hljs-keyword" style="color: #815ba4;">e</span>.sur.<span class="hljs-keyword" style="color: #815ba4;">com</span>/
</code></pre>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">以获取一个文件的信息为例，实际的Rest API URL类似这样:</p>
<pre style="word-wrap: break-word;"><code class="hljs vim" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">http<span class="hljs-variable" style="color: #ef6155;">s:</span>//<span class="hljs-keyword" style="color: #815ba4;">e</span>.sur.<span class="hljs-keyword" style="color: #815ba4;">com</span>/api/v1/<span class="hljs-keyword" style="color: #815ba4;">files</span>/<span class="hljs-number" style="color: #f99b15;">102563</span>
</code></pre>
<h2 id="e799bbe5bd95e58f8ae88eb7e58f96token" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:get_token" target="_blank" style="color: #0088cc; text-decoration: none;">登录及获取token</a></h2>
<h3 id="e68f8fe8bfb0" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;">描述</h3>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">获取访问token，所有的访问请求都需要将此token置于请求头中，见以下示例（假设token字符串为267364823403c247b68dd53a21a3ec6d）：</p>
<pre style="word-wrap: break-word;"><code class="hljs" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">Authorization： Bearer 267364823403c247b68dd53a21a3ec6d
</code></pre>
<h3 id="urle7bb93e69e84" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;">URL结构</h3>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/client/login</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">email</strong> <em style="font-style: italic;">required</em> 用户账号</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">password</strong> <em style="font-style: italic;">required</em> 用户密码的MD5值</p></li>
</ul>
<h4 id="method" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/client/login \
-<span class="ruby">d <span class="hljs-string" style="color: #48b685;">'email=4444&amp;password='</span>cbff36039c3d0212b3e34c23dcde1456<span class="hljs-string" style="color: #48b685;">' \
</span></span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">X</span> <span class="hljs-constant" style="color: #ef6155;">POST</span>
</span></code></pre>
<h4 id="e8bf94e59b9e" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">spaces</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"100"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">state</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"1"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">departments</span>":<span class="hljs-value" style="color: #48b685;">[<span class="hljs-string" style="color: #48b685;">"书生云研发二部"</span>]</span>,
    "<span class="hljs-attribute" style="color: #ef6155;">expires_in</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2518149"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">roleName</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"user"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">adminprivatekey</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"bpqIZEf2zGlOhy9YqhdaUAqlTfnuSXFPcP/woI9XJ08="</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">email</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10811803@qq.com"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"周国昆"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">rootFolderId</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN2833GD"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">resource_server</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"https://e.surdoc.net"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">refresh_token</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"57504db461b8983a62724fc076b4b540"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">recycleBinId</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN2833G5"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">shareFolderRootId</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN1YPKGL"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">privatekey</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"6z37YGwxBrIyvmJ2KKEUGoaVEfQK2gROoTbjcvDS0N0="</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">access_token</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"00910b7deb02db7b76d9aa487b74cf59"</span>
</span>}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">space: 用户空间大小</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">state: 账号状态</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">departments: 用户所属部门</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">expires_in: token超时时间</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">roleName: 用户角色</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">adminprivatekey: 管理员私钥</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">email: 用户email</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">name: 姓名</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">rootFolderId: 根目录id</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">resource_server: 资源服务器</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">refresh_token: 刷新token</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">recycleBinId: 回收站id</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">shareFolderRootId: 共享文件夹根目录id</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">privatekey: 用户私钥</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">access_token: 访问token</p></li>
</ul>
<h2 id="e79baee5bd95" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:dir" target="_blank" style="color: #0088cc; text-decoration: none;">目录</a></h2>
<h3 id="e79baee5bd95e5afb9e8b1a1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:dir_object" target="_blank" style="color: #0088cc; text-decoration: none;">目录对象</a></h3>
<table class="table table-striped  " style="max-width: 100%; background-color: transparent; border-collapse: collapse; border-spacing: 0; width: 100%; margin-bottom: 20px;">
<thead>
<tr>
<th style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: bottom; border-top: 0; font-weight: bold;">属性</th>
<th style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: bottom; border-top: 0; font-weight: bold;">类型</th>
<th style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: bottom; border-top: 0; font-weight: bold;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">type</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">目录始终是"folder"</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">id</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">目录ID，"0"可以代表根目录的ID，"1"代表"/"这个特殊的目录</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">name</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">目录名称</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">createTime</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">目录创建时间，ISO8601格式的时间字符串</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">modifiedTime</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">目录或其中内容的最近修改时间，ISO8601格式的时间字符串</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">creator</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">目录创建者email</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">star</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">boolean</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">是否有星星标记</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">delete</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">boolean</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">是否已经逻辑删除</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">share</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">boolean</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">是否已经共享</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">category</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">目录类型(mrd(MobileAppRootDir，手机根目录),pd(PublicDir, 公共目录),rd(ReceivedDir, 接收的文件目录),sd(SyncDir, 双向同步目录)，其他类型的目录没有此属性)</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">allParentid</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">所有上级目录的id字符串，<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">,</code>分割，例如"1,CN54S3"，"1"是"/"，"CN54S3"才是用户的根目录</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">fileCount</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">integer</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">包括子目录在内，往下递归的所有目录与文件的总数</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">parent</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">Folder object</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">所属目录</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">itemCollection</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">ItemCollection  object</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">目录内容列表(前100个)</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">itemCollection.totalCount</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">integer</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">当前列表包含的内容数</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">itemCollection.entries</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">List</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">目录内容列表(Folder/File Object List)</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">itemCollection.limit</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">integer</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">内容列表一次返回的最大条数 (default=100, max=1000)</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">itemCollection.offset</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">integer</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">内容列表在目录全部内容中的起始位置(default=0)</td>
</tr>
</tbody>
</table>
<h3 id="e88eb7e58f96e79baee5bd95e58583e695b0e68dae" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:get_dir" target="_blank" style="color: #0088cc; text-decoration: none;">获取目录元数据</a></h3>
<h4 id="e68f8fe8bfb0-1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">获取目录的完整元数据</p>
<h4 id="urle7bb93e69e84-1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/folders/{folderId}?withItems=true</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">folderId</strong> <em style="font-style: italic;">required</em> 目录ID(<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">0</code>代表根目录)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">withItems</strong> <em style="font-style: italic;">optional</em> 是否包含着目录下的内容列表, 默认为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">false</code></p></li>
</ul>
<h4 id="method-1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/folders/FOLDER_ID \
-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</span></code></pre>
<h4 id="e8bf94e59b9e-1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">完整的目录对象Json，当目录不存在时会抛出错误</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN1234"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Pictures"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"lucy@email.com"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">star</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">true</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">delete</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">share</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">allParentid</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"1,CN0123"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">fileCount</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">1</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN0123"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"All Files"</span>
    </span>}</span>,
    "<span class="hljs-attribute" style="color: #ef6155;">itemCollection</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">totalCount</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">1</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">entries</span>":<span class="hljs-value" style="color: #48b685;">[
            {
                "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
                "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10239876"</span></span>,
                "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"cat.jpg"</span>
                <span class="hljs-string" style="color: #48b685;">"createTime"</span>:<span class="hljs-string" style="color: #48b685;">"2013-05-14T02:48:13.934Z"</span></span>,
                "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-14T02:48:13.934Z"</span>
                <span class="hljs-string" style="color: #48b685;">"size"</span>:<span class="hljs-number" style="color: #f99b15;">130909</span>
            </span>}
        ]</span>,
        "<span class="hljs-attribute" style="color: #ef6155;">offset</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">0</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">limit</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">100</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有权限访问此目录</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定ID的目录不存在</p></li>
</ul>
<h3 id="e88eb7e58f96e68c87e5ae9ae79baee5bd95e4b88be68980e69c89e58685e5aeb9" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:dir_list" target="_blank" style="color: #0088cc; text-decoration: none;">获取指定目录下所有内容</a></h3>
<h4 id="e68f8fe8bfb0-2" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">获取指定目录下的目录与文件列表，不包含这个目录的元数据。可以使用<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">limit</code>与<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">offset</code>参数分页获取数据。</p>
<h4 id="urle7bb93e69e84-2" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/folders/{folderId}/items?limit=10&amp;offset=0</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">folderId</strong> <em style="font-style: italic;">required</em> 目录ID(<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">0</code>代表根目录)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">folderOnly</strong> <em style="font-style: italic;">optional</em> 内容列表是否只显示目录，默认为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">false</code>
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">true</em> 只显示目录</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">false</em> 目录和文件都显示</p></li>
</ul>
</li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">limit</strong> <em style="font-style: italic;">optional</em> 列表分页时每页的条数, 默认为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">100</code>，超过<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">1000</code>时，服务器强制设定为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">1000</code></p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">offset</strong> <em style="font-style: italic;">optional</em> 列表分页时的起始位置, 默认为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">0</code></p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">order</strong> <em style="font-style: italic;">optional</em> 排序
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">desc</em> 降序，默认</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">asc</em> 升序</p></li>
</ul>
</li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">by</strong> <em style="font-style: italic;">optional</em> 排序的字段，默认根据修改时间排序
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">time</em> 修改时间</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">name</em> 目录与文件的名字</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">size</em> 使用此选项时，因为目录没有size字段，所以还是按目录名排序，文件按照文件大小排序</p></li>
</ul>
</li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">returnType</strong> <em style="font-style: italic;">optional</em> 内部参数
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">simple</em> 只返回部分属性，默认值</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">total</em> 返回更详细的属性，但不是全部</p></li>
</ul>
</li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">showDeleted</strong> <em style="font-style: italic;">optional</em> 内部参数
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">true</em> 返回已经删除的目录或文件信息</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">false</em> 只显示未删除的目录和文件，默认</p></li>
</ul>
</li>
</ul>
<h4 id="method-2" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-2" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs livecodeserver" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl <span class="hljs-keyword" style="color: #815ba4;">https</span>://server/api/v1/<span class="hljs-built_in" style="color: #f99b15;">folders</span>/FOLDER_ID/<span class="hljs-keyword" style="color: #815ba4;">items</span>?limit=LIMIT&amp;<span class="hljs-built_in" style="color: #f99b15;">offset</span>=OFFSET \
-H <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-2" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">目录下的内容集合，当指定目录不存在，或者参数有错误时，会返回错误信息</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">totalCount</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">2</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">entries</span>":<span class="hljs-value" style="color: #48b685;">[
        {
            "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10023645"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Documents"</span>
            <span class="hljs-string" style="color: #48b685;">"createTime"</span>:<span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span>
        </span>},
        {
            "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10056894"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"horse.jpg"</span>
            <span class="hljs-string" style="color: #48b685;">"createTime"</span>:<span class="hljs-string" style="color: #48b685;">"2013-05-13T02:50:13.904Z"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:50:13.904Z"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">size</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">90724</span>
        </span>}
    ]</span>,
    "<span class="hljs-attribute" style="color: #ef6155;">offset</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">0</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">limit</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">2</span>
</span>}
</code></pre>
<h4 id="e99499e8afaf-1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有这个目录的访问权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 对应指定ID的目录不存在</p></li>
</ul>
<h3 id="e5889be5bbbae4b880e4b8aae79baee5bd95" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:dir_create" target="_blank" style="color: #0088cc; text-decoration: none;">创建一个目录</a></h3>
<h4 id="e68f8fe8bfb0-3" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">在指定目录中创建新目录</p>
<h4 id="urle7bb93e69e84-3" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">http://server/api/v1/folders?ondup=rename</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">ondup</strong> <em style="font-style: italic;">optional</em> 存在同名目录时的处理方式，enum(discard, overwrite, rename)
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">discard</strong>: 默认值，直接返回HTTP STATUS <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">409</code>，表示存在同名目录</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">overwrite</strong>: 覆盖已存在的目录(不会删掉已有目录，只是更新一下目录的修改时间)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">rename</strong>: 以<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">dirname(n)</code>的名字创建新目录</p></li>
</ul>
</li>
</ul>
<h4 id="method-3" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl-3" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs stata" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https:<span class="hljs-comment" style="color: #776e71;">//server/api/v1/folders?ondup=rename \</span>
-<span class="hljs-keyword" style="color: #815ba4;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
-<span class="hljs-keyword" style="color: #815ba4;">d</span> '{<span class="hljs-string" style="color: #48b685;">"name"</span>:<span class="hljs-string" style="color: #48b685;">"Folder Name!"</span>,<span class="hljs-string" style="color: #48b685;">"type"</span>:<span class="hljs-string" style="color: #48b685;">"folder"</span>, <span class="hljs-string" style="color: #48b685;">"parent"</span>: {<span class="hljs-string" style="color: #48b685;">"id"</span>: <span class="hljs-string" style="color: #48b685;">"0"</span>,<span class="hljs-string" style="color: #48b685;">"type"</span>:<span class="hljs-string" style="color: #48b685;">"folder"</span>}}' \
-X <span class="hljs-keyword" style="color: #815ba4;">POST</span>
</code></pre>
<h4 id="request20body" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">JSON data</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Folder Name!"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>" : <span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"0"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span>
    </span>}
</span>}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">type</strong>    <em style="font-style: italic;">required</em>    始终设置为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">folder</code>，必选</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">name</strong>    <em style="font-style: italic;">required</em>    目录名称，必选</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">parent</strong>  <em style="font-style: italic;">optional</em>    父目录信息，可选，当在根目录下创建新目录时，可以不带<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">parent</code>属性</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">parent.type</strong>    <em style="font-style: italic;">required</em>    当有<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">parent</code>属性时，<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">parent.type</code>必须指定，始终是<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">folder</code></p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;"><a href="http://parent.id" target="_blank" style="color: #0088cc; text-decoration: none;">parent.id</a></strong>    <em style="font-style: italic;">optional</em> 父目录ID(<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">0</code>或者<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">null</code>，代表根目录)</p></li>
</ul>
<h4 id="e8bf94e59b9e-3" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">当所属目录ID存在，返回完整的新创建的目录对象Json，否则会抛出错误</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN1234"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Folder Name!"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"lucy@email.com"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">star</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">delete</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">share</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">allParentid</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"1,CN0123"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">fileCount</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">0</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN0123"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"All Files"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-2" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有在指定父目录创建新目录的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定ID的父目录不存在</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">409 指定位置存在同名的目录</p></li>
</ul>
<h3 id="e588a0e999a4e79baee5bd95" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:dir_delete" target="_blank" style="color: #0088cc; text-decoration: none;">删除目录</a></h3>
<h4 id="e68f8fe8bfb0-4" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">用来删除一个目录。当目录下有内容时，必须带有<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">recursive</code>参数才能删除。</p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">以下系统目录不允许修改</p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">根目录</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">垃圾桶目录</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">共享目录</p></li>
</ul>
<h4 id="urle7bb93e69e84-4" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">DELETE</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/folders/{folderId}?recursive=true</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">folderId</strong> <em style="font-style: italic;">required</em> 目录ID(<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">0</code>代表根目录，但根目录不允许删除)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">recursive</strong> <em style="font-style: italic;">optional</em> 目录下有内容时，是否删除此目录</p></li>
</ul>
<h4 id="method-4" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">DELETE</code></p>
<h4 id="curl-4" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/folders/FOLDER_ID?recursive=true  \
-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">X</span> <span class="hljs-constant" style="color: #ef6155;">DELETE</span>
</span></code></pre>
<h4 id="e8bf94e59b9e-4" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">一个HTTP 204空response会在删除成功时返回，当目录下包含内容，并且没有使用<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">recursive</code>参数时，会返回错误信息</p>
<h4 id="e99499e8afaf-3" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">304 目录下包含内容，并且没有使用<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">recursive</code>参数时，或者目录是系统目录，不允许修改</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有删除这个目录的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 这个目录不存在</p></li>
</ul>
<h3 id="e7a7bbe58aa8e79baee5bd95" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:dir_move" target="_blank" style="color: #0088cc; text-decoration: none;">移动目录</a></h3>
<h4 id="e68f8fe8bfb0-5" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">移动目录</p>
<h4 id="urle7bb93e69e84-5" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/folders/{folderId}/move?ondup=1</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">folderId</strong> <em style="font-style: italic;">required</em> 将被移动的目录ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">ondup</strong> <em style="font-style: italic;">optional</em> 目标目录存在同名目录或文件时的操作方式：
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">1</strong> 重命名</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">2</strong> 替换(默认)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">3</strong> 保留时间较新的文件</p></li>
</ul>
</li>
</ul>
<h4 id="method-5" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl-5" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs stata" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https:<span class="hljs-comment" style="color: #776e71;">//server/api/v1/folders/FOLDER_ID/move?ondup=1  \</span>
-<span class="hljs-keyword" style="color: #815ba4;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
-<span class="hljs-keyword" style="color: #815ba4;">d</span> '{<span class="hljs-string" style="color: #48b685;">"id"</span>: <span class="hljs-string" style="color: #48b685;">"CN0567"</span>,<span class="hljs-string" style="color: #48b685;">"type"</span>:<span class="hljs-string" style="color: #48b685;">"folder"</span>}' \
-X <span class="hljs-keyword" style="color: #815ba4;">POST</span>
</code></pre>
<h4 id="request20body-1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">JSON data</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN0567"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span>
</span>}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">type</strong>  <em style="font-style: italic;">required</em>  目录始终是<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">folder</code></p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">id</strong>   <em style="font-style: italic;">required</em>    目标目录ID</p></li>
</ul>
<h4 id="e8bf94e59b9e-5" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">当指定目录ID与目标目录ID存在，返回完整的目录对象Json，否则会抛出错误</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN0234"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Folder Name!"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"lucy@email.com"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">star</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">delete</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">share</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">allParentid</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"1,CN0123,CN0567"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">fileCount</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">0</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN0567"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Dest Folder"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-4" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有操作这个目录的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定ID的目录不存在，或者目标目录不存在</p></li>
</ul>
<h3 id="e69bb4e696b0e4b880e4b8aae79baee5bd95" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:dir_update" target="_blank" style="color: #0088cc; text-decoration: none;">更新一个目录</a></h3>
<h4 id="e68f8fe8bfb0-6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">更新指定目录</p>
<h4 id="urle7bb93e69e84-6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT/POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">http://server/api/v1/folders/{folderId}</code></p>
<h4 id="method-6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT/POST</code></p>
<h4 id="curl-6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs stata" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https:<span class="hljs-comment" style="color: #776e71;">//server/api/v1/folders/FOLDER_ID \</span>
-<span class="hljs-keyword" style="color: #815ba4;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
-<span class="hljs-keyword" style="color: #815ba4;">d</span> '{<span class="hljs-string" style="color: #48b685;">"name"</span>:<span class="hljs-string" style="color: #48b685;">"Folder Name!"</span>, <span class="hljs-string" style="color: #48b685;">"type"</span>:<span class="hljs-string" style="color: #48b685;">"folder"</span>}' \
-X <span class="hljs-keyword" style="color: #815ba4;">POST</span>
</code></pre>
<h4 id="request20body-2" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">JSON data</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Folder Name!"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span>
</span>}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">name</strong>    <em style="font-style: italic;">required</em>    目录名称，必选</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">type</strong>  <em style="font-style: italic;">required</em>  目录始终是<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">folder</code></p></li>
</ul>
<h4 id="e8bf94e59b9e-6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">当所属目录ID存在，返回更新后的目录对象Json，否则会抛出错误</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN1234"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Folder Name!"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"lucy@email.com"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">star</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">delete</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">share</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">allParentid</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"1,CN0123"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">fileCount</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">0</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN0123"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"All Files"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-5" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有操作这个目录的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定ID的目录不存在</p></li>
</ul>
<h3 id="e88eb7e58f96e68c87e5ae9ae79baee5bd95e79a84e585a8e8b7afe5be84" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:get_dir_full_path" target="_blank" style="color: #0088cc; text-decoration: none;">获取指定目录的全路径</a></h3>
<h4 id="e68f8fe8bfb0-7" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">获取指定目录的全路径</p>
<h4 id="urle7bb93e69e84-7" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/folders/{folderId}/path</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">folderId</strong> <em style="font-style: italic;">required</em> 目录ID(<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">0</code>代表根目录)</p></li>
</ul>
<h4 id="method-7" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-7" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs elixir" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl <span class="hljs-symbol">https:</span>/<span class="hljs-regexp" style="color: #ef6155;">/server/api</span><span class="hljs-regexp" style="color: #ef6155;">/v1/folders</span><span class="hljs-regexp" style="color: #ef6155;">/FOLDER_ID/path</span> \
-<span class="hljs-constant" style="color: #f99b15;">H </span><span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-7" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">所有父级目录和当前目录组成的Json数组，当目录不存在时会抛出错误</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">[
    {
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN1234"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Folder1"</span>
    </span>},
    {
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN1235"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Folder2"</span>
    </span>},
    {
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN1236"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Folder3"</span>
    </span>},
    {
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN1237"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Current Folder"</span>
    </span>},
]
</code></pre>
<h4 id="e99499e8afaf-6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有权限访问此目录</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定ID的目录不存在</p></li>
</ul>
<h2 id="e69687e4bbb6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:file" target="_blank" style="color: #0088cc; text-decoration: none;">文件</a></h2>
<h3 id="e69687e4bbb6e5afb9e8b1a1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_object" target="_blank" style="color: #0088cc; text-decoration: none;">文件对象</a></h3>
<table class="table table-striped  " style="max-width: 100%; background-color: transparent; border-collapse: collapse; border-spacing: 0; width: 100%; margin-bottom: 20px;">
<thead>
<tr>
<th style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: bottom; border-top: 0; font-weight: bold;">属性</th>
<th style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: bottom; border-top: 0; font-weight: bold;">类型</th>
<th style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: bottom; border-top: 0; font-weight: bold;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">type</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">文件始终是"file"</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">id</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">文件ID</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">name</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">文件名称(包含扩展名)</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">createTime</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">文件在SurDoc服务器的创建时间 (ISO8601)</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">modifiedTime</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">文件在SurDoc服务器上的修改时间 (ISO8601)</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">creator</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">文件创建人email</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">parent</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">Folder object</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">文件所属的目录</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">size</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">long</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">文件大小(byte)</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">star</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">boolean</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">是否有星星标记</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">delete</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">boolean</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">是否已经逻辑删除</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">svgPageCount</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">long</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">svg 页数</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">metaV</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">int</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">1（不能转换）2（可以转换）3（转换中）4（转换失败）5（转换成功）6（新格式转换成功）</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">digest</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">32位MD5</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">version</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">int</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">版本号</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">newDoc</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">boolean</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">双向同步</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">allParentid</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">string</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd;">所有上级目录的id字符串，<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">,</code>分割，例如"1,CN54S3"，"1"是"/"，"CN54S3"才是用户的根目录</td>
</tr>
<tr>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">isSepModified</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">boolean</td>
<td style="padding-top: 8px; padding-right: 8px; padding-bottom: 8px; padding-left: 8px; line-height: 20px; text-align: left; vertical-align: top; border-top: 1px solid #dddddd; background-color: #f9f9f9;">sep文件是否被修改</td>
</tr>
</tbody>
</table>
<h3 id="e4b88ae4bca0e4b880e4b8aae69687e4bbb6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_upload" target="_blank" style="color: #0088cc; text-decoration: none;">上传一个文件</a></h3>
<h4 id="e68f8fe8bfb0-8" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">使用上传接口允许用户添加一个新文件。用户可以指定上传文件的目标目录。如果目标目录存在同名文件，会发生错误。</p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">这个接口使用<a href="http://www.ietf.org/rfc/rfc1867.txt" target="_blank" style="color: #0088cc; text-decoration: none;">Form-based File Upload in HTML</a>方式上传文件，采用<a href="http://www.w3.org/TR/html4/interact/forms.html#h-17.13.4.2" target="_blank" style="color: #0088cc; text-decoration: none;">multipart/form-data</a>数据格式。</p>
<h4 id="urle7bb93e69e84-8" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/e/content</code></p>
<h4 id="e8a1a8e58d95e58583e7b4a0" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">表单元素</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><a href="http://www.ietf.org/rfc/rfc1867.txt" target="_blank" style="color: #0088cc; text-decoration: none;">Form-based File Upload in HTML</a>中的元素</p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">parentId</strong> <em style="font-style: italic;">required</em> 这个文件要上传到的目标目录ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">ondup</strong> <em style="font-style: italic;">optional</em> 目标目录存在同名文件时的处理方式，enum(discard, overwrite, rename)
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">discard</strong>: 默认值，直接返回HTTP STATUS <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">409</code>，表示存在同名文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">overwrite</strong>: 覆盖已存在的同名文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">rename</strong>: 以<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">filename(n).ext</code>的名字重新命名文件</p></li>
</ul>
</li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">file</strong> <em style="font-style: italic;">required</em> 用户磁盘上的文件</p></li>
</ul>
<h4 id="cookie" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Cookie</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">Cookie中必须包含用户的明文私钥</p>
<pre style="word-wrap: break-word;"><code class="hljs css" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;"><span class="hljs-rule"><span class="hljs-attribute" style="color: #fec418;">Cookie</span>:<span class="hljs-value" style="color: #48b685;"> pri=<span class="hljs-number" style="color: #f99b15;">36</span>d4a0c17b66f7d8687a26b9f62fb1d6d7b4f5ffc8111b07911fd8539f</span></span>;
</code></pre>
<h4 id="method-8" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl-8" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl -v https://server/api/v1/files/e/content \ 
-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer 0b23756908ae8d6a49e376f6f13fe310"</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Cookie: pri=36d4a0c17b66f7d8687a26b9f62fb1d6d7b4f5ffc8111b07911fd8539f;"</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">F</span> <span class="hljs-string" style="color: #48b685;">"parentId=US4HF"</span> -<span class="hljs-constant" style="color: #ef6155;">F</span> <span class="hljs-string" style="color: #48b685;">"ondup=rename"</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">F</span> <span class="hljs-string" style="color: #48b685;">"file=@D://test.txt"</span>
</span></code></pre>
<h4 id="e8bf94e59b9e-8" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">当文件所属的目录存在，上传过程也没有问题，则返回完整的文件对象数据。</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"USH56"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"test.txt"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2015-08-31T19:12:51.563Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2015-08-31T19:12:51.563Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"t01@sur.com"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"US4HF"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"root"</span>
    </span>}</span>,
    "<span class="hljs-attribute" style="color: #ef6155;">star</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">delete</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">allParentid</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"1,US4H5,US4HF"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">size</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">2131</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">metaV</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">1</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">version</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">1</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">newDoc</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">digest</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"0eb27ef1ed67c13336f6c4fcee01b7c6"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">thumbnailName</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"0eb27ef1ed67c13336f6c4fcee01b7c61e8ce562d8003e6ba1f555139464f469ced82723853"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">sepModified</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span>
</span>}
</code></pre>
<h4 id="e99499e8afaf-7" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有在这个目录上传文件的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定目录不存在</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">409 指定位置存在同名文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">507 用户空间或者非文档空间已满</p></li>
</ul>
<h3 id="e4b88be8bdbde69687e4bbb6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_download" target="_blank" style="color: #0088cc; text-decoration: none;">下载文件</a></h3>
<h4 id="e68f8fe8bfb0-9" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">从服务器下载指定文件。</p>
<h4 id="urle7bb93e69e84-9" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/web/{fileId}/content</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong> <em style="font-style: italic;">required</em> 文件ID</p></li>
</ul>
<h4 id="method-9" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-9" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs elixir" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl -<span class="hljs-constant" style="color: #f99b15;">L </span><span class="hljs-symbol">https:</span>/<span class="hljs-regexp" style="color: #ef6155;">/server/api</span><span class="hljs-regexp" style="color: #ef6155;">/v1/files</span><span class="hljs-regexp" style="color: #ef6155;">/web/</span><span class="hljs-constant" style="color: #f99b15;">FILE_ID/</span>content \
-<span class="hljs-constant" style="color: #f99b15;">H </span><span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-9" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">如果文件存在，用户有权限读取，则返回文件数据流。</p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">服务器对下载文件请求的HTTP响应如下：</p>
<pre style="word-wrap: break-word;"><code class="hljs groovy" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">&lt; HTTP/<span class="hljs-number" style="color: #f99b15;">1.1</span> <span class="hljs-number" style="color: #f99b15;">200</span> OK
&lt; <span class="hljs-string" style="color: #48b685;">Server:</span> Tengine/<span class="hljs-number" style="color: #f99b15;">1.5</span>.0
&lt; <span class="hljs-string" style="color: #48b685;">Date:</span> Fri, <span class="hljs-number" style="color: #f99b15;">07</span> Mar <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">05</span>:<span class="hljs-number" style="color: #f99b15;">52</span>:<span class="hljs-number" style="color: #f99b15;">24</span> GMT
&lt; Content-<span class="hljs-string" style="color: #48b685;">Type:</span> application/pdf
&lt; Content-<span class="hljs-string" style="color: #48b685;">Length:</span> <span class="hljs-number" style="color: #f99b15;">5463458</span>
&lt; <span class="hljs-string" style="color: #48b685;">Connection:</span> keep-alive
&lt; Content-<span class="hljs-string" style="color: #48b685;">Disposition:</span> attachment;filename=<span class="hljs-string" style="color: #48b685;">"Clojure%20Programming.pdf"</span>;filename*=utf-<span class="hljs-number" style="color: #f99b15;">8</span><span class="hljs-string" style="color: #48b685;">''</span>Clojure%<span class="hljs-number" style="color: #f99b15;">20</span>Programming.pdf
&lt; Accept-<span class="hljs-string" style="color: #48b685;">Ranges:</span> bytes
&lt; <span class="hljs-string" style="color: #48b685;">ETag:</span> <span class="hljs-number" style="color: #f99b15;">102</span>cd5cc1625fed43a5cd058e3a97b0b
&lt; Last-<span class="hljs-string" style="color: #48b685;">Modified:</span> Mon, <span class="hljs-number" style="color: #f99b15;">17</span> Feb <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">09</span>:<span class="hljs-number" style="color: #f99b15;">57</span>:<span class="hljs-number" style="color: #f99b15;">49</span> GMT
&lt; <span class="hljs-string" style="color: #48b685;">Expires:</span> Fri, <span class="hljs-number" style="color: #f99b15;">07</span> Mar <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">06</span>:<span class="hljs-number" style="color: #f99b15;">59</span>:<span class="hljs-number" style="color: #f99b15;">59</span> GMT
&lt; Content-<span class="hljs-string" style="color: #48b685;">Range:</span> bytes <span class="hljs-number" style="color: #f99b15;">0</span>-<span class="hljs-number" style="color: #f99b15;">5463457</span>/<span class="hljs-number" style="color: #f99b15;">5463458</span>
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">ETag</strong> 文件的MD5</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">Content-Disposition</strong> 文件名，格式请参考<a href="http://tools.ietf.org/html/rfc6266#section-5" target="_blank" style="color: #0088cc; text-decoration: none;">RFC 5987</a>的范例</p></li>
</ul>
<h4 id="e99499e8afaf-8" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有下载这个文件的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 文件不存在，或者文件已损坏</p></li>
</ul>
<h3 id="e88eb7e58f96e69687e4bbb6e58583e695b0e68dae" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_get_info" target="_blank" style="color: #0088cc; text-decoration: none;">获取文件元数据</a></h3>
<h4 id="e68f8fe8bfb0-10" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">用户获取文件的元数据</p>
<h4 id="urle7bb93e69e84-10" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/{fileId}</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong> <em style="font-style: italic;">required</em> 文件ID</p></li>
</ul>
<h4 id="method-10" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-10" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/files/FILE_ID \
-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</span></code></pre>
<h4 id="e8bf94e59b9e-10" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">如果文件存在，并且用户有权限访问，则返回文件对象。</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"100256"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"cat.jpg"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Tom Green"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">size</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">653214</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>": <span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"123578"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Pictures"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-9" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有访问这个文件的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 文件不存在</p></li>
</ul>
<h3 id="e7a7bbe58aa8e69687e4bbb6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_move" target="_blank" style="color: #0088cc; text-decoration: none;">移动文件</a></h3>
<h4 id="e68f8fe8bfb0-11" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">移动文件</p>
<h4 id="urle7bb93e69e84-11" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/{fileId}/move?ondup=overwrite</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong> <em style="font-style: italic;">required</em> 将被移动的文件ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">ondup</strong> <em style="font-style: italic;">optional</em> 目标目录存在同名文件时的操作方式：
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">rename</strong> 重命名为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">filename(1).ext</code>(默认)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">overwrite</strong> 用这个文件替换目标目录里的同名文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">newer</strong> 保留时间较新的文件</p></li>
</ul>
</li>
</ul>
<h4 id="method-11" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl-11" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs stata" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https:<span class="hljs-comment" style="color: #776e71;">//server/api/v1/files/FILE_ID/move?ondup=overwrite  \</span>
-<span class="hljs-keyword" style="color: #815ba4;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
-<span class="hljs-keyword" style="color: #815ba4;">d</span> '{<span class="hljs-string" style="color: #48b685;">"id"</span>: <span class="hljs-string" style="color: #48b685;">"10036454"</span>,<span class="hljs-string" style="color: #48b685;">"type"</span>:<span class="hljs-string" style="color: #48b685;">"folder"</span>}' \
-X <span class="hljs-keyword" style="color: #815ba4;">POST</span>
</code></pre>
<h4 id="request20body-3" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">目标目录信息的JSON data</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036454"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span>
</span>}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">type</strong>  <em style="font-style: italic;">required</em>  目录始终是<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">folder</code></p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">id</strong>   <em style="font-style: italic;">required</em>    目标目录ID</p></li>
</ul>
<h4 id="e8bf94e59b9e-11" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">如果指定ID的文件存在，而且目标目录存在，则返回文件对象。</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036578"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"new name.jpg"</span>
    <span class="hljs-string" style="color: #48b685;">"size"</span>:<span class="hljs-number" style="color: #f99b15;">954623</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Tom Lee"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036454"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Pictures"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-10" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有访问这个文件的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定ID的文件不存在，或者目标目录不存在</p></li>
</ul>
<h3 id="e5a48de588b6e69687e4bbb6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_copy" target="_blank" style="color: #0088cc; text-decoration: none;">复制文件</a></h3>
<h4 id="e68f8fe8bfb0-12" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">复制文件</p>
<h4 id="urle7bb93e69e84-12" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/{fileId}/copy?ondup=overwrite</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong> <em style="font-style: italic;">required</em> 将被复制的文件ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">ondup</strong> <em style="font-style: italic;">optional</em> 目标目录存在同名文件时的操作方式：
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">rename</strong> 重命名为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">filename(1).ext</code>(默认)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">overwrite</strong> 用这个文件替换目标目录里的同名文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">newer</strong> 保留时间较新的文件</p></li>
</ul>
</li>
</ul>
<h4 id="method-12" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl-12" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs stata" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https:<span class="hljs-comment" style="color: #776e71;">//server/api/v1/files/FILE_ID/copy?ondup=overwrite  \</span>
-<span class="hljs-keyword" style="color: #815ba4;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
-<span class="hljs-keyword" style="color: #815ba4;">d</span> '{<span class="hljs-string" style="color: #48b685;">"id"</span>: <span class="hljs-string" style="color: #48b685;">"10036454"</span>,<span class="hljs-string" style="color: #48b685;">"type"</span>:<span class="hljs-string" style="color: #48b685;">"folder"</span>}' \
-X <span class="hljs-keyword" style="color: #815ba4;">POST</span>
</code></pre>
<h4 id="request20body-4" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">目标目录信息的JSON data</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036454"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span>
</span>}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">type</strong>  <em style="font-style: italic;">required</em>  目录始终是<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">folder</code></p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">id</strong>   <em style="font-style: italic;">required</em>    目标目录ID</p></li>
</ul>
<h4 id="e8bf94e59b9e-12" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">如果指定ID的文件存在，而且目标目录存在，则返回文件对象。</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036578"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"new name.jpg"</span>
    <span class="hljs-string" style="color: #48b685;">"size"</span>:<span class="hljs-number" style="color: #f99b15;">954623</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Tom Lee"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036454"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Pictures"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-11" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有访问这个文件的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定ID的文件不存在，或者目标目录不存在</p></li>
</ul>
<h3 id="e588a0e999a4e69687e4bbb6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_delete" target="_blank" style="color: #0088cc; text-decoration: none;">删除文件</a></h3>
<h4 id="e68f8fe8bfb0-13" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">删除一个文件</p>
<h4 id="urle7bb93e69e84-13" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">DELETE</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/{fileId}</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong> <em style="font-style: italic;">required</em> 文件ID</p></li>
</ul>
<h4 id="method-13" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">DELETE</code></p>
<h4 id="curl-13" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/files/FILE_ID  \
-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">X</span> <span class="hljs-constant" style="color: #ef6155;">DELETE</span>
</span></code></pre>
<h4 id="e8bf94e59b9e-13" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">一个HTTP 204空response会在删除成功时返回</p>
<h4 id="e99499e8afaf-12" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有访问这个文件的权限</p></li>
</ul>
<h3 id="e4bfaee694b9e69687e4bbb6e58583e695b0e68dae" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_update_info" target="_blank" style="color: #0088cc; text-decoration: none;">修改文件元数据</a></h3>
<h4 id="e68f8fe8bfb0-14" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">目前仅支持修改文件名。</p>
<h4 id="urle7bb93e69e84-14" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/{fileId}</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong> <em style="font-style: italic;">required</em> 文件ID</p></li>
</ul>
<h4 id="method-14" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT</code></p>
<h4 id="curl-14" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/files/FILE_ID \
-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
</span>-<span class="ruby">d <span class="hljs-string" style="color: #48b685;">'{"name":"new name.jpg","type":"file"}'</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">X</span> <span class="hljs-constant" style="color: #ef6155;">PUT</span>
</span></code></pre>
<h4 id="request20body-5" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">JSON data</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"new name.jpg"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span>
</span>}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">type</strong>  <em style="font-style: italic;">required</em>  始终是<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">file</code></p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">name</strong>    <em style="font-style: italic;">optional</em>    新文件名，可选，当不需要修改文件名的时候，可以不带这个属性</p></li>
</ul>
<h4 id="e8bf94e59b9e-14" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">如果文件存在，而且没有文件名冲突，则返回文件对象。</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036578"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"new name.jpg"</span>
    <span class="hljs-string" style="color: #48b685;">"size"</span>:<span class="hljs-number" style="color: #f99b15;">954623</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Tom Lee"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036454"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Pictures"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-13" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有访问这个文件的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定ID的文件不存在，或者新的父目录ID不存在</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">409 在指定目录存在同名文件</p></li>
</ul>
<h2 id="e5a29ee9878fe69bb4e696b0e79bb8e585b3api" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:dir_file_changes" target="_blank" style="color: #0088cc; text-decoration: none;">增量更新相关API</a></h2>
<h3 id="e88eb7e58f96e794a8e688b7e7a9bae997b4e4bfa1e681af" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:get_user_space" target="_blank" style="color: #0088cc; text-decoration: none;">获取用户空间信息</a></h3>
<h4 id="e68f8fe8bfb0-15" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">获取用户的云盘空间相关信息</p>
<h4 id="urle7bb93e69e84-15" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/space</code></p>
<h4 id="method-15" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-15" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs elixir" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl <span class="hljs-symbol">https:</span>/<span class="hljs-regexp" style="color: #ef6155;">/server/api</span><span class="hljs-regexp" style="color: #ef6155;">/v1/space</span>\
-<span class="hljs-constant" style="color: #f99b15;">H </span><span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-15" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<pre style="word-wrap: break-word;"><code class="hljs elixir" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    <span class="hljs-string" style="color: #48b685;">"allSpace"</span><span class="hljs-symbol">:</span><span class="hljs-number" style="color: #f99b15;">10737418240</span>, <span class="hljs-regexp" style="color: #ef6155;">//</span>部门空间大小
    <span class="hljs-string" style="color: #48b685;">"publicDirID"</span><span class="hljs-symbol">:<span class="hljs-string" style="color: #48b685;">"US4HB"</span></span>,  <span class="hljs-regexp" style="color: #ef6155;">//</span>公共文件夹<span class="hljs-constant" style="color: #f99b15;">ID</span>
    <span class="hljs-string" style="color: #48b685;">"creator"</span><span class="hljs-symbol">:<span class="hljs-string" style="color: #48b685;">"t01@sur.com"</span></span>,<span class="hljs-regexp" style="color: #ef6155;">//</span>空间所属帐号
    <span class="hljs-string" style="color: #48b685;">"usedSpace"</span><span class="hljs-symbol">:</span><span class="hljs-number" style="color: #f99b15;">8872850269</span>, <span class="hljs-regexp" style="color: #ef6155;">//</span>用户空间大小
    <span class="hljs-string" style="color: #48b685;">"receivedID"</span><span class="hljs-symbol">:<span class="hljs-string" style="color: #48b685;">"US4H9"</span></span>,   <span class="hljs-regexp" style="color: #ef6155;">//</span>接收到的文件文件夹<span class="hljs-constant" style="color: #f99b15;">ID</span>
    <span class="hljs-string" style="color: #48b685;">"recycleDirId"</span><span class="hljs-symbol">:<span class="hljs-string" style="color: #48b685;">"US4H7"</span></span>, <span class="hljs-regexp" style="color: #ef6155;">//</span>回收站文件夹<span class="hljs-constant" style="color: #f99b15;">ID</span>
    <span class="hljs-string" style="color: #48b685;">"userID"</span><span class="hljs-symbol">:</span><span class="hljs-number" style="color: #f99b15;">21</span>,            <span class="hljs-regexp" style="color: #ef6155;">//</span>用户<span class="hljs-constant" style="color: #f99b15;">ID</span>
    <span class="hljs-string" style="color: #48b685;">"isSubscribe"</span><span class="hljs-symbol">:true</span>,     <span class="hljs-regexp" style="color: #ef6155;">//</span>是否付费（只用于<span class="hljs-constant" style="color: #f99b15;">SMAR）</span>
    <span class="hljs-string" style="color: #48b685;">"usedNonFileSpace"</span><span class="hljs-symbol">:</span><span class="hljs-number" style="color: #f99b15;">6243884048</span>,<span class="hljs-regexp" style="color: #ef6155;">//</span>已使用的非文档空间大小
    <span class="hljs-string" style="color: #48b685;">"userID36"</span><span class="hljs-symbol">:<span class="hljs-string" style="color: #48b685;">"USL"</span></span>,       <span class="hljs-regexp" style="color: #ef6155;">//</span><span class="hljs-number" style="color: #f99b15;">36</span>进制字符串的用户<span class="hljs-constant" style="color: #f99b15;">ID</span>
    <span class="hljs-string" style="color: #48b685;">"regTime"</span><span class="hljs-symbol">:<span class="hljs-string" style="color: #48b685;">"2015-05-09T08:54:29Z"</span></span>,<span class="hljs-regexp" style="color: #ef6155;">//</span>注册时间
    <span class="hljs-string" style="color: #48b685;">"syncDirId"</span><span class="hljs-symbol">:<span class="hljs-string" style="color: #48b685;">"US4HD"</span></span>,    <span class="hljs-regexp" style="color: #ef6155;">//</span>双向同步文件夹<span class="hljs-constant" style="color: #f99b15;">ID</span>
    <span class="hljs-string" style="color: #48b685;">"singleNonFileSize"</span><span class="hljs-symbol">:</span><span class="hljs-number" style="color: #f99b15;">10995116277760</span>,<span class="hljs-regexp" style="color: #ef6155;">//</span>单个非文档大小限制
    <span class="hljs-string" style="color: #48b685;">"rootDirId"</span><span class="hljs-symbol">:<span class="hljs-string" style="color: #48b685;">"US4H5"</span></span>,    <span class="hljs-regexp" style="color: #ef6155;">//</span>根目录<span class="hljs-constant" style="color: #f99b15;">ID（</span>只用于个人盘）
    <span class="hljs-string" style="color: #48b685;">"allNonFileSpace"</span><span class="hljs-symbol">:</span><span class="hljs-number" style="color: #f99b15;">10995116277760</span>,<span class="hljs-regexp" style="color: #ef6155;">//</span>全部非文档空间大小
    <span class="hljs-string" style="color: #48b685;">"userType"</span><span class="hljs-symbol">:<span class="hljs-string" style="color: #48b685;">"user_active"</span>//</span>用户类型
}
</code></pre>
<h3 id="e794a8e688b7e6a0b9e79baee5bd95e69c80e5908ee4bfaee694b9e697b6e997b4" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:root_dir_last_modified" target="_blank" style="color: #0088cc; text-decoration: none;">用户根目录最后修改时间</a></h3>
<h4 id="e68f8fe8bfb0-16" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">获取用户根目录最后修改时间</p>
<h4 id="urle7bb93e69e84-16" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/space/update</code></p>
<h4 id="method-16" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-16" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/space/update \
-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</span></code></pre>
<h4 id="e8bf94e59b9e-16" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">用户根目录最后修改时间</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">userLastModifyTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span>
</span>}
</code></pre>
<h3 id="e79baee5bd95e5a29ee9878fe69bb4e696b0e69fa5e8afa2" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:dir_changes" target="_blank" style="color: #0088cc; text-decoration: none;">目录增量更新查询</a></h3>
<h4 id="e68f8fe8bfb0-17" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">获取从指定时间开始，有变化的目录列表，可以使用<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">limit</code>和<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">offset</code>分页获取。</p>
<h4 id="urle7bb93e69e84-17" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/folders/changes?limit=10&amp;offset=0&amp;syncTime=2013-05-13T02:48:13.934Z&amp;returnType=total</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">syncTime</strong> <em style="font-style: italic;">optional</em> 起始时间点，默认为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">1970-01-01T00:00:00.000Z</code></p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">limit</strong> <em style="font-style: italic;">optional</em> 每页多少条数据，默认为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">200</code>条，最多限制<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">2000</code>条</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">offset</strong> <em style="font-style: italic;">optional</em> 分页时，用来指定内容输出的起始位置，默认为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">0</code></p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">returnType</strong> <em style="font-style: italic;">optional</em> 返回简单数据，还是完整数据
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">simple</strong> 简单的目录数据，默认值</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">total</strong> 完整的目录数据</p></li>
</ul>
</li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">showDeleted</strong> <em style="font-style: italic;">optional</em> 是否显示已删除的目录，默认不显示(<em style="font-style: italic;">内部参数</em>)</p></li>
</ul>
<h4 id="method-17" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-17" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs nix" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/folders/changes?<span class="hljs-variable" style="color: #ef6155;">limit=</span>LIMIT&amp;<span class="hljs-variable" style="color: #ef6155;">offset=</span>OFFSET&amp;<span class="hljs-variable" style="color: #ef6155;">syncTime=</span>TIME&amp;<span class="hljs-variable" style="color: #ef6155;">returnType=</span>RETURNTYPE \
-H <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-17" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">有变化的目录列表</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">[
    ...
    {
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN0234"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Folder Name!"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"lucy@email.com"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">star</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">delete</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">share</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">allParentid</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"1,CN0123,CN0567"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">fileCount</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">0</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
            "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"CN0567"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Dest Folder"</span>
        </span>}
    </span>},
    ...
]
</code></pre>
<h3 id="e69687e4bbb6e5a29ee9878fe69bb4e696b0e69fa5e8afa2" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_changes" target="_blank" style="color: #0088cc; text-decoration: none;">文件增量更新查询</a></h3>
<h4 id="e68f8fe8bfb0-18" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">获取从指定时间开始，有变化的文件列表。可以使用<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">limit</code>和<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">offset</code>参数分页获取数据。</p>
<h4 id="urle7bb93e69e84-18" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/changes?limit=10&amp;offset=0&amp;syncTime=2013-05-13T02:48:13.934Z&amp;returnType=total</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">syncTime</strong> <em style="font-style: italic;">optional</em> 起始时间点，默认为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">1970-01-01T00:00:00.000Z</code></p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">limit</strong> <em style="font-style: italic;">optional</em> 每页多少条数据，默认为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">200</code>条，最多限制<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">2000</code>条</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">offset</strong> <em style="font-style: italic;">optional</em> 分页时，用来指定内容输出的起始位置，默认为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">0</code></p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">returnType</strong> <em style="font-style: italic;">optional</em> 返回简单数据，还是完整数据
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">simple</strong> 简单的文件数据，默认值</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">total</strong> 完整的文件数据</p></li>
</ul>
</li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">showDeleted</strong> <em style="font-style: italic;">optional</em> 是否显示已删除的目录，默认不显示(<em style="font-style: italic;">内部参数</em>)</p></li>
</ul>
<h4 id="method-18" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-18" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs nix" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/files/changes?<span class="hljs-variable" style="color: #ef6155;">limit=</span>LIMIT&amp;<span class="hljs-variable" style="color: #ef6155;">offset=</span>OFFSET&amp;<span class="hljs-variable" style="color: #ef6155;">syncTime=</span>TIME&amp;<span class="hljs-variable" style="color: #ef6155;">returnType=</span>RETURNTYPE \
-H <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-18" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">有变化的文件列表</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">[
    ...
    {
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036578"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"new name.jpg"</span>
        <span class="hljs-string" style="color: #48b685;">"size"</span>:<span class="hljs-number" style="color: #f99b15;">954623</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Tom Lee"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
            "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036454"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Pictures"</span>
        </span>}
    </span>},
    ...
]
</code></pre>
<h2 id="surdoce5ae89e585a8e4b88ae4bca0e68ea5e58fa3api" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:security_upload" target="_blank" style="color: #0088cc; text-decoration: none;">Surdoc安全上传接口API</a></h2>
<h3 id="e6a0b9e68daee69198e8a681e588a4e696ade69687e4bbb6e698afe590a6e5b7b2e7bb8fe5ad98e59ca8efbc88e69687e4bbb6e58ebbe9878de588a4e696adefbc89" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_is_exist" target="_blank" style="color: #0088cc; text-decoration: none;">根据摘要判断文件是否已经存在（文件去重判断）</a></h3>
<h4 id="e68f8fe8bfb0-19" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">根据摘要信息判断文件是否存在，如果存在则直接通过秒传接口进行秒传，否则进行正常的文件上传</p>
<h4 id="urle7bb93e69e84-19" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/security/isExist?hash=xxxxxxxxxxxxxxxxxxxxxxxxxxx</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">hash</strong>  <em style="font-style: italic;">必选项</em>  明文文件摘要(md5+sha1+hexString(fileSize))</p></li>
</ul>
<h4 id="method-19" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-19" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs elixir" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl <span class="hljs-symbol">https:</span>/<span class="hljs-regexp" style="color: #ef6155;">/server/api</span><span class="hljs-regexp" style="color: #ef6155;">/v1/files</span><span class="hljs-regexp" style="color: #ef6155;">/security/is</span>Exist?hash=<span class="hljs-constant" style="color: #f99b15;">HASH</span>
-<span class="hljs-constant" style="color: #f99b15;">H </span><span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-19" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">返回查询出来的具有相同摘要的文件的密文密钥相关的列表</p>
<pre style="word-wrap: break-word;"><code class="hljs clojure" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;"><span class="hljs-collection">[
    <span class="hljs-collection">{
        <span class="hljs-string" style="color: #48b685;">"hash"</span>:<span class="hljs-string" style="color: #48b685;">"xxxxxxxxxxxx"</span>，  //文件明文摘要<span class="hljs-list">(<span class="hljs-keyword" style="color: #815ba4;">md5+sha1+hexString</span><span class="hljs-list">(<span class="hljs-keyword" style="color: #815ba4;">fileSize</span>)</span>)</span>
        <span class="hljs-string" style="color: #48b685;">"enc_hash"</span>:<span class="hljs-string" style="color: #48b685;">"xxxxxxxxxx"</span>, //文件密文摘要<span class="hljs-list">(<span class="hljs-keyword" style="color: #815ba4;">sha1</span>)</span>
        <span class="hljs-string" style="color: #48b685;">"shareKey"</span>:<span class="hljs-string" style="color: #48b685;">"xxxxxxxxxxx"</span>, //文件的共享密钥，使用用户明文摘要对明文密钥加密的密钥
        <span class="hljs-string" style="color: #48b685;">"size"</span><span class="hljs-attribute" style="color: #ef6155;">:xxx</span>,               //明文文件大小
        <span class="hljs-string" style="color: #48b685;">"enc_size"</span><span class="hljs-attribute" style="color: #ef6155;">:xxx</span>            //密文文件大小
    }</span>,  
    
    .....
    <span class="hljs-collection">{
        <span class="hljs-string" style="color: #48b685;">"hash"</span>:<span class="hljs-string" style="color: #48b685;">"xxxxxxxxxxxx"</span>，  //文件明文摘要<span class="hljs-list">(<span class="hljs-keyword" style="color: #815ba4;">md5+sha1+hexString</span><span class="hljs-list">(<span class="hljs-keyword" style="color: #815ba4;">fileSize</span>)</span>)</span>
        <span class="hljs-string" style="color: #48b685;">"enc_hash"</span>:<span class="hljs-string" style="color: #48b685;">"xxxxxxxxxx"</span>, //文件密文摘要<span class="hljs-list">(<span class="hljs-keyword" style="color: #815ba4;">sha1</span>)</span>
        <span class="hljs-string" style="color: #48b685;">"shareKey"</span>:<span class="hljs-string" style="color: #48b685;">"xxxxxxxxxxx"</span>, //文件的共享密钥，使用用户明文摘要对明文密钥加密的密钥
        <span class="hljs-string" style="color: #48b685;">"size"</span><span class="hljs-attribute" style="color: #ef6155;">:xxx</span>,               //明文文件大小
        <span class="hljs-string" style="color: #48b685;">"enc_size"</span><span class="hljs-attribute" style="color: #ef6155;">:xxx</span>            //密文文件大小
    }</span>,  
]</span>
</code></pre>
<h4 id="e99499e8afaf-14" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 根据摘要没有找到匹配的信息</p></li>
</ul>
<h3 id="e7a792e4bca0" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_rapidupload" target="_blank" style="color: #0088cc; text-decoration: none;">秒传</a></h3>
<h4 id="e68f8fe8bfb0-20" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">如果isExists不返回404,调用者根据其返回的列表获取了文件的明文密钥后，经过加密之后进行秒传处理，秒传处理只记录文件的元信息，而不需要调用者上传文件</p>
<h4 id="urle7bb93e69e84-20" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/security/rapidupload?filename=xxx&amp;digest=xxx&amp;filesize=xxx&amp;encdigest=xxx&amp;seckey=xxx&amp;enckey=xxx&amp;sharekey=xxx&amp;encfilesize=xxx&amp;convert=xxx&amp;ondup=xxx&amp;parentId=xxx&amp;createTime=xxx</code></p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">URL Query String中的参数如下：</p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">filename</strong> <em style="font-style: italic;">必填项</em> 文件名</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">digest</strong> <em style="font-style: italic;">必填项</em> 文件的明文摘要(md5+sha1+hexString(filesize))</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">filesize</strong> _<em style="font-style: italic;">必填项</em> 文件的明文大小</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">encdigest</strong> <em style="font-style: italic;">必填项</em> 文件的密文摘要(sha1)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">seckey</strong> <em style="font-style: italic;">选填项</em> 文件的明文存储密钥(44字节,传输编码为base64WebSafe)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">enckey</strong> <em style="font-style: italic;">必填项</em> 文件的密文存储密钥(使用用户公钥对明文私钥进行ECC非对称加密得到的结果，传输编码为base64WebSafe)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">shareKey</strong> <em style="font-style: italic;">必填项</em> 文件的共享密钥(使用文件明文摘要对明文密钥进行AES加密得到的结果，传输编码为base64WebSafe)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">encfilesize</strong> <em style="font-style: italic;">必填项</em> 文件的密文大小</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">convert</strong> <em style="font-style: italic;">选填项</em> true/false 是否进行转换,默认为false; 如果convert=true则参数seckey必须填写</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">ondup</strong> <em style="font-style: italic;">选填项</em> discard/overwrite/rename 文件重名时的策略
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">discard</em>  不进行任何处理,直接返回409,并且本次秒传失败,详见__错误__</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">overwrite</em> 覆盖原同名文件,原同名文件变成历史版本,当前版本为新上传的文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">rename</em> 重命名,重命名格式为 "文件名(n)" ,n为数字</p></li>
</ul>
</li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">createTime</strong> <em style="font-style: italic;">选填项</em> 文件创建时间,默认由系统生成</p></li>
</ul>
<h4 id="e8a1a8e58d95e58583e7b4a0-1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">表单元素</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">queryString的所有参数都可以作为表单元素来进行提交</p>
<h4 id="method-20" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl-20" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs nix" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/files/security/rapidupload?<span class="hljs-variable" style="color: #ef6155;">filename=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">digest=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">filesize=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">encdigest=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">seckey=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">enckey=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">sharekey=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">encfilesize=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">convert=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">ondup=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">parentId=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">createTime=</span>xxx
-H <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
-X POST
</code></pre>
<h4 id="e8bf94e59b9e-20" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">返回文件的完整元信息</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036578"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"cat.jpg"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">size</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">954623</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Tom Lee"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036454"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Pictures"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-15" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有在这个目录上传文件的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定目录不存在</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">409 指定位置存在同名文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">507 用户空间或者非文档空间已满</p></li>
</ul>
<h3 id="e99d9ee5a4a7e69687e4bbb6e4b88ae4bca0" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_upload" target="_blank" style="color: #0088cc; text-decoration: none;">非大文件上传</a></h3>
<h4 id="e68f8fe8bfb0-21" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">用户通过这个接口进行文件上传，该接口不支持断点续传</p>
<h4 id="urle7bb93e69e84-21" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/security/upload?filename=xxx&amp;digest=xxx&amp;filesize=xxx&amp;encdigest=xxx&amp;seckey=xxx&amp;enckey=xxx&amp;sharekey=xxx&amp;encfilesize=xxx&amp;convert=xxx&amp;ondup=xxx&amp;parentId=xxx&amp;createTime=xxx</code></p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">URL Query String中的参数如下：</p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">filename</strong> <em style="font-style: italic;">必填项</em> 文件名</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">digest</strong> <em style="font-style: italic;">必填项</em> 文件的明文摘要(md5+sha1+hexString(filesize))</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">filesize</strong> _<em style="font-style: italic;">必填项</em> 文件的明文大小</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">encdigest</strong> <em style="font-style: italic;">必填项</em> 文件的密文摘要(sha1)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">seckey</strong> <em style="font-style: italic;">选填项</em> 文件的明文存储密钥(44字节,传输编码为base64WebSafe)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">enckey</strong> <em style="font-style: italic;">必填项</em> 文件的密文存储密钥(使用用户公钥对明文私钥进行ECC非对称加密得到的结果，传输编码为base64WebSafe)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">shareKey</strong> <em style="font-style: italic;">必填项</em> 文件的共享密钥(使用文件明文摘要对明文密钥进行AES加密得到的结果，传输编码为base64WebSafe)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">encfilesize</strong> <em style="font-style: italic;">必填项</em> 文件的密文大小</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">convert</strong> <em style="font-style: italic;">选填项</em> true/false 是否进行转换,默认为false; 如果convert=true则参数seckey必须填写</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">ondup</strong> <em style="font-style: italic;">选填项</em> discard/overwrite/rename 文件重名时的策略
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">discard</em>  不进行任何处理,直接返回409,并且本次秒传失败,详见__错误__</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">overwrite</em> 覆盖原同名文件,原同名文件变成历史版本,当前版本为新上传的文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">rename</em> 重命名,重命名格式为 "文件名(n)" ,n为数字</p></li>
</ul>
</li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">createTime</strong> <em style="font-style: italic;">选填项</em> 文件创建时间,默认由系统生成</p></li>
</ul>
<h4 id="e8a1a8e58d95e58583e7b4a0-2" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">表单元素</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">file</strong> <em style="font-style: italic;">必填项</em> 用户磁盘上的经过压缩加密的文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">query string中所有的参数都可作为表单元素的一部分来进行提交</p></li>
</ul>
<h4 id="method-21" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl-21" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs nix" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/files/security/upload?<span class="hljs-variable" style="color: #ef6155;">filename=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">digest=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">filesize=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">encdigest=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">seckey=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">enckey=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">sharekey=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">encfilesize=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">convert=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">ondup=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">parentId=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">createTime=</span>xxx
-H <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
-F <span class="hljs-variable" style="color: #ef6155;">file=</span>@FILE_PATH_ON_DISK 
-X POST
</code></pre>
<h4 id="e8bf94e59b9e-21" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">返回文件的完整元信息</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036578"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"cat.jpg"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">size</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">954623</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Tom Lee"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036454"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Pictures"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-16" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有在这个目录上传文件的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定目录不存在</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">409 指定位置存在同名文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">507 用户空间或者非文档空间已满</p></li>
</ul>
<h3 id="e5a4a7e69687e4bbb6e79a84e4b88ae4bca0e4b88ee7bbade4bca0" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_resumable" target="_blank" style="color: #0088cc; text-decoration: none;">大文件的上传与续传</a></h3>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">大文件的上传，与断点续传</p>
<h4 id="1e794b3e8afb7e4b88ae4bca0e59cb0e59d80" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;"><a href="id:file_resumable_upload_id" target="_blank" style="color: #0088cc; text-decoration: none;">1.申请上传地址</a></h4>
<h4 id="e68f8fe8bfb0-22" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">用户在进行大文件上传之前，需要通过该接口获取一个uploadid,后续在续传的时候需要uploadId来进行续传</p>
<h4 id="urle7bb93e69e84-22" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v2/files/security/content?uploadType=resumable</code></p>
<h4 id="method-22" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl-22" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v2/files/security/content?uploadType=resumable
-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">X</span> <span class="hljs-constant" style="color: #ef6155;">POST</span>
</span></code></pre>
<h4 id="e8bf94e59b9e-22" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<pre style="word-wrap: break-word;"><code class="hljs ruby" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">包含<span class="hljs-string" style="color: #48b685;">`Location`</span>头信息的空内容返回
<span class="hljs-constant" style="color: #ef6155;">HTTP</span>/<span class="hljs-number" style="color: #f99b15;">1.1</span> <span class="hljs-number" style="color: #f99b15;">200</span> <span class="hljs-constant" style="color: #ef6155;">OK</span>
<span class="hljs-constant" style="color: #ef6155;">Location</span><span class="hljs-symbol" style="color: #48b685;">:</span> <span class="hljs-symbol" style="color: #48b685;">https:</span>/<span class="hljs-regexp" style="color: #ef6155;">/server/api</span><span class="hljs-regexp" style="color: #ef6155;">/v2/files</span><span class="hljs-regexp" style="color: #ef6155;">/security/content</span>?uploadType=resumable&amp;upload_id=xxxxxxxxx
<span class="hljs-constant" style="color: #ef6155;">Content</span>-<span class="hljs-constant" style="color: #ef6155;">Length</span><span class="hljs-symbol" style="color: #48b685;">:</span> <span class="hljs-number" style="color: #f99b15;">0</span>

头信息中的<span class="hljs-constant" style="color: #ef6155;">Location</span>，就是最终要进行文件上传的<span class="hljs-constant" style="color: #ef6155;">URL</span>
复制并保存好这个<span class="hljs-constant" style="color: #ef6155;">URL</span>，以用在后续的请求中
</code></pre>
<h4 id="2e4b88ae4bca0e69687e4bbb6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;"><a href="id:file_resumable_upload_data" target="_blank" style="color: #0088cc; text-decoration: none;">2.上传文件</a></h4>
<h4 id="e68f8fe8bfb0-23" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">上传文件，向上一步获取到的URL发送<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT</code>请求</p>
<pre style="word-wrap: break-word;"><code class="hljs roboconf" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;"><span class="hljs-component">PUT {resumableLocation}</span>
</code></pre>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">HTTP头信息中要包含<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">Content-Length</code>，数值为你这次请求要上传的字节数，实际上就是要上传的文件字节数。</p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">URL的<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">filename</code>参数为文件名称，包含扩展名，可选的<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">parentId</code>参数为上传文件的目录ID，默认为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">根目录</code></p>
<h4 id="urle7bb93e69e84-23" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v2/files/security/content?uploadType=resumable&amp;uploadId=xxxxxxx&amp;filename=xxx&amp;digest=xxx&amp;filesize=xxx&amp;encdigest=xxx&amp;seckey=xxx&amp;enckey=xxx&amp;sharekey=xxx&amp;encfilesize=xxx&amp;convert=xxx&amp;ondup=xxx&amp;parentId=xxx&amp;createTime=xxx</code></p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">URL Query String中的参数如下：</p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">uploadType</strong> <em style="font-style: italic;">必填项</em> 取值只能是resumable</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">uploadId</strong> <em style="font-style: italic;">必填项</em> 上传ID，通过调用<a href="id:file_resumable_upload_id" target="_blank" style="color: #0088cc; text-decoration: none;">申请上传地址</a>获得</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">filename</strong> <em style="font-style: italic;">必填项</em> 文件名</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">digest</strong> <em style="font-style: italic;">必填项</em> 文件的明文摘要(md5+sha1+hexString(filesize))</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">filesize</strong> _<em style="font-style: italic;">必填项</em> 文件的明文大小</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">encdigest</strong> <em style="font-style: italic;">必填项</em> 文件的密文摘要(sha1)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">seckey</strong> <em style="font-style: italic;">选填项</em> 文件的明文存储密钥(44字节,传输编码为base64WebSafe)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">enckey</strong> <em style="font-style: italic;">必填项</em> 文件的密文存储密钥(使用用户公钥对明文私钥进行ECC非对称加密得到的结果，传输编码为base64WebSafe)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">shareKey</strong> <em style="font-style: italic;">必填项</em> 文件的共享密钥(使用文件明文摘要对明文密钥进行AES加密得到的结果，传输编码为base64WebSafe)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">encfilesize</strong> <em style="font-style: italic;">必填项</em> 文件的密文大小</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">convert</strong> <em style="font-style: italic;">选填项</em> true/false 是否进行转换,默认为false; 如果convert=true则参数seckey必须填写</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">ondup</strong> <em style="font-style: italic;">选填项</em> discard/overwrite/rename 文件重名时的策略
</p><ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 0; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">discard</em>  不进行任何处理,直接返回409,并且本次秒传失败,详见__错误__</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">overwrite</em> 覆盖原同名文件,原同名文件变成历史版本,当前版本为新上传的文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><em style="font-style: italic;">rename</em> 重命名,重命名格式为 "文件名(n)" ,n为数字</p></li>
</ul>
</li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">createTime</strong> <em style="font-style: italic;">选填项</em> 文件创建时间,默认由系统生成</p></li>
</ul>
<h4 id="curl-23" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl "https://server/api/v1/files/security/content?uploadType=resumable&amp;uploadId=xxxxxxx&amp;filename=xxx&amp;digest=xxx&amp;filesize=xxx&amp;encdigest=xxx&amp;seckey=xxx&amp;enckey=xxx&amp;sharekey=xxx&amp;encfilesize=xxx&amp;convert=xxx&amp;ondup=xxx&amp;parentId=xxx&amp;createTime=xxx" \
-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Content-Length: xxxxxxxxxx"</span>
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Content-Type: application/octet-stream"</span>
</span>-<span class="ruby">-upload-file /path/to/the/file
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">X</span> <span class="hljs-constant" style="color: #ef6155;">PUT</span>
</span></code></pre>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">其中，<strong style="font-weight: bold;">Content-Length</strong> <em style="font-style: italic;">必填项</em> 上传文件的大小</p>
<h4 id="e8bf94e59b9e-23" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">如果文件上传成功，返回文件信息</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036578"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"new name.jpg"</span>
    <span class="hljs-string" style="color: #48b685;">"size"</span>:<span class="hljs-number" style="color: #f99b15;">954623</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Tom Lee"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036454"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Pictures"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-17" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有在这个目录上传文件的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 指定目录不存在</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">409 指定位置存在同名文件</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">507 用户空间已满</p></li>
</ul>
<h4 id="3e7bba7e7bbade4b8ade696ade79a84e4b88ae4bca0" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;"><a href="id:file_resumable_upload_data_after_break" target="_blank" style="color: #0088cc; text-decoration: none;">3.继续中断的上传</a></h4>
<ol style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">获取文件已上传到服务器的字节数</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">继续上传余下的文件字节数据</p></li>
</ol>
<h4 id="3120e88eb7e58f96e69687e4bbb6e5b7b2e4b88ae4bca0e588b0e69c8de58aa1e599a8e79a84e5ad97e88a82e695b0" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">3.1 获取文件已上传到服务器的字节数</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">向之前保存的上传地址发送<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code>请求，在HTTP头信息中带上<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">Content-Range</code>，来告诉服务器索取已上传的文件字节数，假如你的文件大小是2,000,000，则设置<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">Content-Range</code>为<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">*/2000000</code>。</p>
<pre style="word-wrap: break-word;"><code class="hljs http" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;"><span class="hljs-request">GET <span class="hljs-string" style="color: #48b685;">https://server/api/v2/files/security/content?uploadType=resumable&amp;upload_id=0be366130ca04191b7a8f228e6c017d5</span> HTTP/1.1</span>
<span class="hljs-attribute" style="color: #ef6155;">Authorization</span>: <span class="hljs-string" style="color: #48b685;">Bearer ACCESS_TOKEN</span>
<span class="hljs-attribute" style="color: #ef6155;">Content-Length</span>: <span class="hljs-string" style="color: #48b685;">0</span>
<span class="hljs-attribute" style="color: #ef6155;">Content-Range</span>: <span class="hljs-string" style="color: #48b685;">*/2000000</span>
</code></pre>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">服务器返回的内容中，用HTTP头信息的<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">Offset</code>来表示目前已经接收到<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">43</code>字节。你要使用<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">Offset</code>的数值来决定从那个字节开始续传。</p>
<pre style="word-wrap: break-word;"><code class="hljs http" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;"><span class="hljs-status">HTTP/1.1 <span class="hljs-number" style="color: #f99b15;">308</span></span>
<span class="hljs-attribute" style="color: #ef6155;">Content-Length</span>: <span class="hljs-string" style="color: #48b685;">0</span>
<span class="hljs-attribute" style="color: #ef6155;">Offset</span>: <span class="hljs-string" style="color: #48b685;">43</span>
</code></pre>
<h4 id="3220e7bba7e7bbade4b88ae4bca0e4bd99e4b88be79a84e69687e4bbb6e5ad97e88a82e695b0e68dae" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">3.2 继续上传余下的文件字节数据</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">从第<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">43</code>字节开始继续上传文件余下的字节数据</p>
<pre style="word-wrap: break-word;"><code class="hljs nix" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">PUT https://server/api/v2/files/security/content??<span class="hljs-variable" style="color: #ef6155;">uploadType=</span>resumable&amp;<span class="hljs-variable" style="color: #ef6155;">uploadId=</span>xxxxxxx&amp;<span class="hljs-variable" style="color: #ef6155;">filename=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">digest=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">filesize=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">encdigest=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">seckey=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">enckey=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">sharekey=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">encfilesize=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">convert=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">ondup=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">parentId=</span>xxx&amp;<span class="hljs-variable" style="color: #ef6155;">createTime=</span>xxx HTTP/<span class="hljs-number" style="color: #f99b15;">1.1</span>
Authorization: Bearer ACCESS_TOKEN
Content-Length: <span class="hljs-number" style="color: #f99b15;">1999957</span>
Content-Type: application/octet-stream
Content-Range: bytes <span class="hljs-number" style="color: #f99b15;">43</span>-<span class="hljs-number" style="color: #f99b15;">1999999</span>/<span class="hljs-number" style="color: #f99b15;">2000000</span>

{bytes <span class="hljs-number" style="color: #f99b15;">43</span>-<span class="hljs-number" style="color: #f99b15;">1999999</span>}
</code></pre>
<h3 id="e4b88be8bdbde5af86e69687e69687e4bbb6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:file_download" target="_blank" style="color: #0088cc; text-decoration: none;">下载密文文件</a></h3>
<h4 id="e68f8fe8bfb0-24" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">从服务器下载指定文件的密文，支持HTTP标准的断点续传。</p>
<h4 id="urle7bb93e69e84-24" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/security/{fileId}/content</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong> <em style="font-style: italic;">required</em> 文件ID</p></li>
</ul>
<h4 id="method-23" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-24" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs elixir" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl -<span class="hljs-constant" style="color: #f99b15;">L </span><span class="hljs-symbol">https:</span>/<span class="hljs-regexp" style="color: #ef6155;">/server/api</span><span class="hljs-regexp" style="color: #ef6155;">/v1/files</span><span class="hljs-regexp" style="color: #ef6155;">/security/</span><span class="hljs-constant" style="color: #f99b15;">FILE_ID/</span>content \
-<span class="hljs-constant" style="color: #f99b15;">H </span><span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-24" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">如果文件存在，用户有权限读取，则返回文件数据流。</p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">服务器对下载文件请求的HTTP响应如下：</p>
<pre style="word-wrap: break-word;"><code class="hljs groovy" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">&lt; HTTP/<span class="hljs-number" style="color: #f99b15;">1.1</span> <span class="hljs-number" style="color: #f99b15;">200</span> OK
&lt; <span class="hljs-string" style="color: #48b685;">Server:</span> Tengine/<span class="hljs-number" style="color: #f99b15;">1.5</span>.0
&lt; <span class="hljs-string" style="color: #48b685;">Date:</span> Fri, <span class="hljs-number" style="color: #f99b15;">07</span> Mar <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">05</span>:<span class="hljs-number" style="color: #f99b15;">52</span>:<span class="hljs-number" style="color: #f99b15;">24</span> GMT
&lt; Content-<span class="hljs-string" style="color: #48b685;">Type:</span> application/pdf
&lt; Content-<span class="hljs-string" style="color: #48b685;">Length:</span> <span class="hljs-number" style="color: #f99b15;">5463458</span>
&lt; <span class="hljs-string" style="color: #48b685;">Connection:</span> keep-alive
&lt; Content-<span class="hljs-string" style="color: #48b685;">Disposition:</span> attachment;filename=<span class="hljs-string" style="color: #48b685;">"Clojure%20Programming.pdf"</span>;filename*=utf-<span class="hljs-number" style="color: #f99b15;">8</span><span class="hljs-string" style="color: #48b685;">''</span>Clojure%<span class="hljs-number" style="color: #f99b15;">20</span>Programming.pdf
&lt; Accept-<span class="hljs-string" style="color: #48b685;">Ranges:</span> bytes
&lt; <span class="hljs-string" style="color: #48b685;">ETag:</span> <span class="hljs-number" style="color: #f99b15;">102</span>cd5cc1625fed43a5cd058e3a97b0b
&lt; ENC-<span class="hljs-string" style="color: #48b685;">KEY:</span> <span class="hljs-number" style="color: #f99b15;">102</span>cd5cc1625fed43a5cd058e3a97b0b
&lt; Last-<span class="hljs-string" style="color: #48b685;">Modified:</span> Mon, <span class="hljs-number" style="color: #f99b15;">17</span> Feb <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">09</span>:<span class="hljs-number" style="color: #f99b15;">57</span>:<span class="hljs-number" style="color: #f99b15;">49</span> GMT
&lt; <span class="hljs-string" style="color: #48b685;">Expires:</span> Fri, <span class="hljs-number" style="color: #f99b15;">07</span> Mar <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">06</span>:<span class="hljs-number" style="color: #f99b15;">59</span>:<span class="hljs-number" style="color: #f99b15;">59</span> GMT
&lt; Content-<span class="hljs-string" style="color: #48b685;">Range:</span> bytes <span class="hljs-number" style="color: #f99b15;">0</span>-<span class="hljs-number" style="color: #f99b15;">5463457</span>/<span class="hljs-number" style="color: #f99b15;">5463458</span>
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">ENC-KEY</strong> 文件的密文存储密钥(调用者需用私钥进行解密，来得到明文密钥)</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">ETag</strong> 密文文件的SHA1摘要</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">Content-Disposition</strong> 文件名，格式请参考<a href="http://tools.ietf.org/html/rfc6266#section-5" target="_blank" style="color: #0088cc; text-decoration: none;">RFC 5987</a>的范例</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">支持客户端使用 HTTP Header <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">If-None-Match</code>, <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">If-Match</code>来比对文件的MD5，或者使用<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">If-Modified-Since</code>或者<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">If-Unmodified-Since</code>来比对文件修改时间</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">支持客户端使用 HTTP Header <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">Range</code>进行文件下载的断点续传，但服务器只允许一次指定一个字节范围，而且字节范围的结尾必须是文件字节的结尾，也就是不允许下载文件中间的某一段数据，只允许从文件字节开头或者文件中间开始，一直到文件结尾。</p></li>
</ul>
<h4 id="e99499e8afaf-18" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">403 用户没有下载这个文件的权限</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 文件不存在，或者文件已损坏</p></li>
</ul>
<h2 id="e78988e69cace68ea7e588b6e79bb8e585b3e68ea5e58fa3efbc88e4b8aae4babaefbc89" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:version_control_of_private_files" target="_blank" style="color: #0088cc; text-decoration: none;">版本控制相关接口（个人）</a></h2>
<h3 id="e88eb7e58f96e78988e69cace58897e8a1a8" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:get_version_list" target="_blank" style="color: #0088cc; text-decoration: none;">获取版本列表</a></h3>
<h4 id="e68f8fe8bfb0-25" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">根据文件ID获取该文件所有版本的列表</p>
<h4 id="urle7bb93e69e84-25" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/version/{fileId}/list</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong>  <em style="font-style: italic;">必选项</em>  文件ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">offset</strong>  <em style="font-style: italic;">可选项</em>  结果列表的偏移量</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">limit</strong>   <em style="font-style: italic;">可选项</em>  需要获取的条目数</p></li>
</ul>
<h4 id="method-24" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-25" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs vim" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl http<span class="hljs-variable" style="color: #ef6155;">s:</span>//server/api/v1/<span class="hljs-keyword" style="color: #815ba4;">files</span>/<span class="hljs-keyword" style="color: #815ba4;">version</span>/FILE_ID/<span class="hljs-keyword" style="color: #815ba4;">list</span>?offset=<span class="hljs-number" style="color: #f99b15;">0</span>&amp;limit=<span class="hljs-number" style="color: #f99b15;">100</span> 
-H <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-25" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">返回查询出来的文件版本信息列表</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">[
    {
        "<span class="hljs-attribute" style="color: #ef6155;">svgPageCount</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">1</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"US2LABY"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2014-11-05T03:21:22Z"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2014-11-05T03:21:22Z"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"新建文本文档 (2).txt"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">digest</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"e19b56eef528cd92efcc841c6c1cd709db258663f7f0e23c9973ec9cf7246483d56e97042b"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">allParentid</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"1,USALUN,USALUX,USAJ0I"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">version</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">1</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">metaV</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"6"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">size</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">43</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"tttttttenginxfangzhenemp8956@8888.com"</span>
    </span>}
]
</code></pre>
<h4 id="e99499e8afaf-19" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 文件不存在</p></li>
</ul>
<h3 id="e4baa4e68da2e78988e69cac" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:swap_version" target="_blank" style="color: #0088cc; text-decoration: none;">交换版本</a></h3>
<h4 id="e68f8fe8bfb0-26" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">根据文件ID将某个历史版本替换成当前版本</p>
<h4 id="urle7bb93e69e84-26" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/version/{fileId}/{version}/swap</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong>  <em style="font-style: italic;">必选项</em>  文件ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">version</strong>  <em style="font-style: italic;">必选项</em>  版本号</p></li>
</ul>
<h4 id="method-25" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-26" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs elixir" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl <span class="hljs-symbol">https:</span>/<span class="hljs-regexp" style="color: #ef6155;">/server/api</span><span class="hljs-regexp" style="color: #ef6155;">/v1/files</span><span class="hljs-regexp" style="color: #ef6155;">/version/</span><span class="hljs-constant" style="color: #f99b15;">FILE_ID/VERSION/</span>swap 
-<span class="hljs-constant" style="color: #f99b15;">H </span><span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-26" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">JSON数据</p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">{"success":true}</p>
<h4 id="e99499e8afaf-20" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 文件不存在</p></li>
</ul>
<h3 id="e4b88be8bdbde69f90e4b8aae78988e69cac" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:version_download" target="_blank" style="color: #0088cc; text-decoration: none;">下载某个版本</a></h3>
<h4 id="e68f8fe8bfb0-27" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">根据文件ID和版本号下载某个历史版本</p>
<h4 id="urle7bb93e69e84-27" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/security/version/{fileId}/{version}/content</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong>  <em style="font-style: italic;">必选项</em>  文件ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">version</strong>  <em style="font-style: italic;">必选项</em>  版本号</p></li>
</ul>
<h4 id="method-26" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-27" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs elixir" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl <span class="hljs-symbol">https:</span>/<span class="hljs-regexp" style="color: #ef6155;">/server/api</span><span class="hljs-regexp" style="color: #ef6155;">/v1/files</span><span class="hljs-regexp" style="color: #ef6155;">/security/version</span><span class="hljs-regexp" style="color: #ef6155;">/FILE_ID/</span><span class="hljs-constant" style="color: #f99b15;">VERSION/</span>content 
-<span class="hljs-constant" style="color: #f99b15;">H </span><span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-27" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">如果文件存在，则返回文件数据流。</p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">服务器对下载文件请求的HTTP响应如下：</p>
<pre style="word-wrap: break-word;"><code class="hljs perl" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">&lt; <span class="hljs-number" style="color: #f99b15;">200</span>
&lt; Server: Tengine/<span class="hljs-number" style="color: #f99b15;">1.5</span>.<span class="hljs-number" style="color: #f99b15;">0</span>
&lt; Date: Mon, <span class="hljs-number" style="color: #f99b15;">10</span> Nov <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">02</span>:<span class="hljs-number" style="color: #f99b15;">58</span>:<span class="hljs-number" style="color: #f99b15;">53</span> GMT
&lt; Content-Type: application/octet-stream
&lt; Content-Length: <span class="hljs-number" style="color: #f99b15;">64</span>
&lt; Connection: keep-alive
&lt; Content-Disposition: attachment;filename=<span class="hljs-string" style="color: #48b685;">"<span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%B0</span><span class="hljs-variable" style="color: #ef6155;">%E5</span><span class="hljs-variable" style="color: #ef6155;">%BB</span><span class="hljs-variable" style="color: #ef6155;">%BA</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%87</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%9C</span><span class="hljs-variable" style="color: #ef6155;">%AC</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%87</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%A1</span><span class="hljs-variable" style="color: #ef6155;">%A3</span><span class="hljs-variable" style="color: #ef6155;">%20</span><span class="hljs-variable" style="color: #ef6155;">%282</span><span class="hljs-variable" style="color: #ef6155;">%29</span>.txt"</span>;filename*=utf-<span class="hljs-number" style="color: #f99b15;">8</span><span class="hljs-string" style="color: #48b685;">''</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%B0</span><span class="hljs-variable" style="color: #ef6155;">%E5</span><span class="hljs-variable" style="color: #ef6155;">%BB</span><span class="hljs-variable" style="color: #ef6155;">%BA</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%87</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%9C</span><span class="hljs-variable" style="color: #ef6155;">%AC</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%87</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%A1</span><span class="hljs-variable" style="color: #ef6155;">%A3</span><span class="hljs-variable" style="color: #ef6155;">%20</span><span class="hljs-variable" style="color: #ef6155;">%282</span><span class="hljs-variable" style="color: #ef6155;">%29</span>.txt
&lt; Accept-Ranges: bytes
&lt; ETag: <span class="hljs-number" style="color: #f99b15;">6</span>f73f91b
&lt; Last-Modified: Wed, <span class="hljs-number" style="color: #f99b15;">05</span> Nov <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">03</span>:<span class="hljs-number" style="color: #f99b15;">22</span>:<span class="hljs-number" style="color: #f99b15;">17</span> GMT
&lt; Expires: Mon, <span class="hljs-number" style="color: #f99b15;">10</span> Nov <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">03</span>:<span class="hljs-number" style="color: #f99b15;">58</span>:<span class="hljs-number" style="color: #f99b15;">53</span> GMT
&lt; ENC-KEY: MIIBWDCCAQwwgccGByqGSM49AgEwgbsCAQEwEgICAOkGCSqGSM49AQIDAgIBSjBABB4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEEHgBmZH7ebDMsf4wJI7tYITszOyDpzkKB_hFffY-QrQQ9BAD6yd_LrIMTuyE58bt1X-<span class="hljs-number" style="color: #f99b15;">9</span>lvDkfizb4-Otzcf1ViwEAagikGQM1BnjlhSi-v4oL7_hnp8o2cW9-AfgQUgIeAQAAAAAAAAAAAAAAAAAAE-l05y-KaSIDHSYDz-DXAgECA0AABD0EAYJVbrI1Qckue1lhfWBg9s97ZQI8mlGzTMJpceOPAYoJDoedEiIgAu6l5Xqt0_5uC-mlfusQpBF6fMNwBDA2nPFL77DGzqnw5PVGeXyPp9KZXMAwxFzLkf28YnUJqjQk8PFlYXKnlKn1jfV6vKMEFH_A1bfnmaWnTaOfUGEqJgEDMm68
&lt; X-Origin-Filesize: <span class="hljs-number" style="color: #f99b15;">64</span>
&lt; Content-Range: bytes <span class="hljs-number" style="color: #f99b15;">0</span>-<span class="hljs-number" style="color: #f99b15;">63</span>/<span class="hljs-number" style="color: #f99b15;">64</span>
</code></pre>
<h4 id="e99499e8afaf-21" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 文件不存在</p></li>
</ul>
<h2 id="e78988e69cace68ea7e588b6e79bb8e585b3e68ea5e58fa3efbc88e585b1e4baabe69687e4bbb6e5a4b9efbc89" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:version_control_of_shared_files" target="_blank" style="color: #0088cc; text-decoration: none;">版本控制相关接口（共享文件夹）</a></h2>
<h3 id="e88eb7e58f96e78988e69cace58897e8a1a8-1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:get_shared_version_list" target="_blank" style="color: #0088cc; text-decoration: none;">获取版本列表</a></h3>
<h4 id="e68f8fe8bfb0-28" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">根据文件ID获取该文件所有版本的列表</p>
<h4 id="urle7bb93e69e84-28" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/sharefolders/files/version/{fileId}/list</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong>  <em style="font-style: italic;">必选项</em>  文件ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">offset</strong>  <em style="font-style: italic;">可选项</em>  结果列表的偏移量</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">limit</strong>   <em style="font-style: italic;">可选项</em>  需要获取的条目数</p></li>
</ul>
<h4 id="method-27" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-28" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs elixir" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl <span class="hljs-symbol">https:</span>/<span class="hljs-regexp" style="color: #ef6155;">/server/api</span><span class="hljs-regexp" style="color: #ef6155;">/v1/sharefolders</span><span class="hljs-regexp" style="color: #ef6155;">/files/version</span><span class="hljs-regexp" style="color: #ef6155;">/FILE_ID/list</span>?offset=<span class="hljs-number" style="color: #f99b15;">0</span>&amp;limit=<span class="hljs-number" style="color: #f99b15;">100</span> 
-<span class="hljs-constant" style="color: #f99b15;">H </span><span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-28" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">返回查询出来的文件版本信息列表</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">[
    {
        "<span class="hljs-attribute" style="color: #ef6155;">svgPageCount</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">1</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"US2LABY"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2014-11-05T03:21:22Z"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2014-11-05T03:21:22Z"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"新建文本文档 (2).txt"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">digest</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"e19b56eef528cd92efcc841c6c1cd709db258663f7f0e23c9973ec9cf7246483d56e97042b"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">allParentid</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"1,USALUN,USALUX,USAJ0I"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">version</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">1</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">metaV</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"6"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">size</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">43</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"tttttttenginxfangzhenemp8956@8888.com"</span>
    </span>}
]
</code></pre>
<h4 id="e99499e8afaf-22" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 文件不存在</p></li>
</ul>
<h3 id="e4baa4e68da2e78988e69cac-1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:swap_shared_version" target="_blank" style="color: #0088cc; text-decoration: none;">交换版本</a></h3>
<h4 id="e68f8fe8bfb0-29" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">根据文件ID将某个历史版本替换成当前版本</p>
<h4 id="urle7bb93e69e84-29" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/sharefolders/files/version/{fileId}/{version}/swap</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong>  <em style="font-style: italic;">必选项</em>  文件ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">version</strong>  <em style="font-style: italic;">必选项</em>  版本号</p></li>
</ul>
<h4 id="method-28" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-29" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs elixir" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl <span class="hljs-symbol">https:</span>/<span class="hljs-regexp" style="color: #ef6155;">/server/api</span><span class="hljs-regexp" style="color: #ef6155;">/v1/sharefolders</span><span class="hljs-regexp" style="color: #ef6155;">/files/version</span><span class="hljs-regexp" style="color: #ef6155;">/FILE_ID/</span><span class="hljs-constant" style="color: #f99b15;">VERSION/</span>swap 
-<span class="hljs-constant" style="color: #f99b15;">H </span><span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-29" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">JSON数据</p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">{"success":true}</p>
<h4 id="e99499e8afaf-23" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 文件不存在</p></li>
</ul>
<h3 id="e4b88be8bdbde69f90e4b8aae78988e69cac-1" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:shared_version_download" target="_blank" style="color: #0088cc; text-decoration: none;">下载某个版本</a></h3>
<h4 id="e68f8fe8bfb0-30" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">根据文件ID和版本号下载某个历史版本</p>
<h4 id="urle7bb93e69e84-30" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/sharefolders/files/security/version/{fileId}/{version}/content</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong>  <em style="font-style: italic;">必选项</em>  文件ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">version</strong>  <em style="font-style: italic;">必选项</em>  版本号</p></li>
</ul>
<h4 id="method-29" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-30" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs elixir" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl <span class="hljs-symbol">https:</span>/<span class="hljs-regexp" style="color: #ef6155;">/server/api</span><span class="hljs-regexp" style="color: #ef6155;">/v1/sharefolders</span><span class="hljs-regexp" style="color: #ef6155;">/files/security</span><span class="hljs-regexp" style="color: #ef6155;">/version/</span>{fileId}/{version}/content 
-<span class="hljs-constant" style="color: #f99b15;">H </span><span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</code></pre>
<h4 id="e8bf94e59b9e-30" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">如果文件存在，则返回文件数据流。</p>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">服务器对下载文件请求的HTTP响应如下：</p>
<pre style="word-wrap: break-word;"><code class="hljs perl" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">&lt; <span class="hljs-number" style="color: #f99b15;">200</span>
&lt; Server: Tengine/<span class="hljs-number" style="color: #f99b15;">1.5</span>.<span class="hljs-number" style="color: #f99b15;">0</span>
&lt; Date: Mon, <span class="hljs-number" style="color: #f99b15;">10</span> Nov <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">02</span>:<span class="hljs-number" style="color: #f99b15;">58</span>:<span class="hljs-number" style="color: #f99b15;">53</span> GMT
&lt; Content-Type: application/octet-stream
&lt; Content-Length: <span class="hljs-number" style="color: #f99b15;">64</span>
&lt; Connection: keep-alive
&lt; Content-Disposition: attachment;filename=<span class="hljs-string" style="color: #48b685;">"<span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%B0</span><span class="hljs-variable" style="color: #ef6155;">%E5</span><span class="hljs-variable" style="color: #ef6155;">%BB</span><span class="hljs-variable" style="color: #ef6155;">%BA</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%87</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%9C</span><span class="hljs-variable" style="color: #ef6155;">%AC</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%87</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%A1</span><span class="hljs-variable" style="color: #ef6155;">%A3</span><span class="hljs-variable" style="color: #ef6155;">%20</span><span class="hljs-variable" style="color: #ef6155;">%282</span><span class="hljs-variable" style="color: #ef6155;">%29</span>.txt"</span>;filename*=utf-<span class="hljs-number" style="color: #f99b15;">8</span><span class="hljs-string" style="color: #48b685;">''</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%B0</span><span class="hljs-variable" style="color: #ef6155;">%E5</span><span class="hljs-variable" style="color: #ef6155;">%BB</span><span class="hljs-variable" style="color: #ef6155;">%BA</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%87</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%9C</span><span class="hljs-variable" style="color: #ef6155;">%AC</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%96</span><span class="hljs-variable" style="color: #ef6155;">%87</span><span class="hljs-variable" style="color: #ef6155;">%E6</span><span class="hljs-variable" style="color: #ef6155;">%A1</span><span class="hljs-variable" style="color: #ef6155;">%A3</span><span class="hljs-variable" style="color: #ef6155;">%20</span><span class="hljs-variable" style="color: #ef6155;">%282</span><span class="hljs-variable" style="color: #ef6155;">%29</span>.txt
&lt; Accept-Ranges: bytes
&lt; ETag: <span class="hljs-number" style="color: #f99b15;">6</span>f73f91b
&lt; Last-Modified: Wed, <span class="hljs-number" style="color: #f99b15;">05</span> Nov <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">03</span>:<span class="hljs-number" style="color: #f99b15;">22</span>:<span class="hljs-number" style="color: #f99b15;">17</span> GMT
&lt; Expires: Mon, <span class="hljs-number" style="color: #f99b15;">10</span> Nov <span class="hljs-number" style="color: #f99b15;">2014</span> <span class="hljs-number" style="color: #f99b15;">03</span>:<span class="hljs-number" style="color: #f99b15;">58</span>:<span class="hljs-number" style="color: #f99b15;">53</span> GMT
&lt; ENC-KEY: MIIBWDCCAQwwgccGByqGSM49AgEwgbsCAQEwEgICAOkGCSqGSM49AQIDAgIBSjBABB4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEEHgBmZH7ebDMsf4wJI7tYITszOyDpzkKB_hFffY-QrQQ9BAD6yd_LrIMTuyE58bt1X-<span class="hljs-number" style="color: #f99b15;">9</span>lvDkfizb4-Otzcf1ViwEAagikGQM1BnjlhSi-v4oL7_hnp8o2cW9-AfgQUgIeAQAAAAAAAAAAAAAAAAAAE-l05y-KaSIDHSYDz-DXAgECA0AABD0EAYJVbrI1Qckue1lhfWBg9s97ZQI8mlGzTMJpceOPAYoJDoedEiIgAu6l5Xqt0_5uC-mlfusQpBF6fMNwBDA2nPFL77DGzqnw5PVGeXyPp9KZXMAwxFzLkf28YnUJqjQk8PFlYXKnlKn1jfV6vKMEFH_A1bfnmaWnTaOfUGEqJgEDMm68
&lt; X-Origin-Filesize: <span class="hljs-number" style="color: #f99b15;">64</span>
&lt; Content-Range: bytes <span class="hljs-number" style="color: #f99b15;">0</span>-<span class="hljs-number" style="color: #f99b15;">63</span>/<span class="hljs-number" style="color: #f99b15;">64</span>
</code></pre>
<h4 id="e99499e8afaf-24" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 文件不存在</p></li>
</ul>
<h2 id="e585b1e4baabe79baee5bd95e79bb8e585b3e68ea5e58fa3" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:share_folder" target="_blank" style="color: #0088cc; text-decoration: none;">共享目录相关接口</a></h2>
<h3 id="e88eb7e58f96e585b1e4baabe69687e4bbb6e5a4b9" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:get_share_folders" target="_blank" style="color: #0088cc; text-decoration: none;">获取共享文件夹</a></h3>
<h4 id="e68f8fe8bfb0-31" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">获取当前用户的共享文件夹列表</p>
<h4 id="urle7bb93e69e84-31" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/sharefolders/list</code></p>
<h4 id="method-30" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">GET</code></p>
<h4 id="curl-31" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/sharefolders/list \
-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span>
</span></code></pre>
<h4 id="e8bf94e59b9e-31" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">返回共享文件夹集合，entries是由文件夹JSON对象组成的数组</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">totalCount</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">1</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">entries</span>":<span class="hljs-value" style="color: #48b685;">[
        {
            "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"USLOM"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"测试1的共享文件夹"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2015-08-30T19:59:03.000Z"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2015-08-30T19:59:03.000Z"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"wuhao@sursen.net"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
                "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
                "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"USL5A"</span>
            </span>}</span>,
            "<span class="hljs-attribute" style="color: #ef6155;">star</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">delete</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">allParentid</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"1,USL55,USL5A"</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">share</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-literal" style="color: #f99b15;">false</span></span>,
            "<span class="hljs-attribute" style="color: #ef6155;">fileCount</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">0</span>
        </span>}
    ]</span>,
    "<span class="hljs-attribute" style="color: #ef6155;">limit</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">1</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">offset</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">0</span>
</span>}
</code></pre>
<h3 id="e7a7bbe58aa8e69687e4bbb6e887b3e585b1e4baabe79baee5bd95" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:move_file_to_share_folder" target="_blank" style="color: #0088cc; text-decoration: none;">移动文件至共享目录</a></h3>
<h4 id="e68f8fe8bfb0-32" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">根据文件ID将该文件移动至共享目录中的某个目录</p>
<h4 id="urle7bb93e69e84-32" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/sharefolders/{destFolderId}/movein?shareFolderId={shareFolderId}&amp;enckey={enckey}</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">destFolderId</strong>  <em style="font-style: italic;">必选项</em>  目标目录ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">sharedFolderId</strong>  <em style="font-style: italic;">必选项</em>  目标目录所属的共享目录ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">enckey</strong>   <em style="font-style: italic;">必选项</em> 使用共享目录的私钥对文件的明文密钥加密的密文密钥，需转换为hex string</p></li>
</ul>
<h4 id="method-31" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl-32" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs stata" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https:<span class="hljs-comment" style="color: #776e71;">//server/api/v1/sharefolders/DEST_FOLDER_ID/movein?shareFolderId=SHARE_FOLDER_ID&amp;enckey=ENCKEY \</span>
-<span class="hljs-keyword" style="color: #815ba4;">d</span> '{<span class="hljs-string" style="color: #48b685;">"id"</span>:<span class="hljs-string" style="color: #48b685;">"FILE_ID"</span>, <span class="hljs-string" style="color: #48b685;">"type"</span>:<span class="hljs-string" style="color: #48b685;">"file"</span>}' \
-<span class="hljs-keyword" style="color: #815ba4;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
-X <span class="hljs-keyword" style="color: #815ba4;">POST</span>
</code></pre>
<h4 id="request20body-6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">JSON data</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"{fileId}"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span>
</span>}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">id</strong>    <em style="font-style: italic;">required</em>  文件ID，必选</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">type</strong>  <em style="font-style: italic;">required</em>  文件始终是<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">file</code></p></li>
</ul>
<h4 id="e8bf94e59b9e-32" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">被移动的文件信息</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036578"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"new name.jpg"</span>
    <span class="hljs-string" style="color: #48b685;">"size"</span>:<span class="hljs-number" style="color: #f99b15;">954623</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Tom Lee"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036454"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Pictures"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-25" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 文件不存在</p></li>
</ul>
<h3 id="e5a48de588b6e69687e4bbb6e887b3e585b1e4baabe79baee5bd95" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:copy_file_to_share_folder" target="_blank" style="color: #0088cc; text-decoration: none;">复制文件至共享目录</a></h3>
<h4 id="e68f8fe8bfb0-33" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">根据文件ID将该文件复制到共享目录中的某个目录</p>
<h4 id="urle7bb93e69e84-33" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/sharefolders/{destFolderId}/copyin?shareFolderId={shareFolderId}&amp;enckey={enckey}</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">destFolderId</strong>  <em style="font-style: italic;">必选项</em>  目标目录ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">sharedFolderId</strong>  <em style="font-style: italic;">必选项</em>  目标目录所属的共享目录ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">enckey</strong>   <em style="font-style: italic;">必选项</em> 使用共享目录的私钥对文件的明文密钥加密的密文密钥，需转换为hex string</p></li>
</ul>
<h4 id="method-32" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl-33" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs stata" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https:<span class="hljs-comment" style="color: #776e71;">//server/api/v1/sharefolders/DEST_FOLDER_ID/copyin?shareFolderId=SHARE_FOLDER_ID&amp;enckey=ENCKEY \</span>
-<span class="hljs-keyword" style="color: #815ba4;">d</span> '{<span class="hljs-string" style="color: #48b685;">"id"</span>:<span class="hljs-string" style="color: #48b685;">"FILE_ID"</span>, <span class="hljs-string" style="color: #48b685;">"type"</span>:<span class="hljs-string" style="color: #48b685;">"file"</span>}' \
-<span class="hljs-keyword" style="color: #815ba4;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
-X <span class="hljs-keyword" style="color: #815ba4;">POST</span>
</code></pre>
<h4 id="request20body-7" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">JSON data</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"{fileId}"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>" : <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span>
</span>}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">id</strong>    <em style="font-style: italic;">required</em>  文件ID，必选</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">type</strong>  <em style="font-style: italic;">required</em>  文件始终是<code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">file</code></p></li>
</ul>
<h4 id="e8bf94e59b9e-33" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">被复制的文件信息</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"file"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036578"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"new name.jpg"</span>
    <span class="hljs-string" style="color: #48b685;">"size"</span>:<span class="hljs-number" style="color: #f99b15;">954623</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">createTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">modifiedTime</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"2013-05-13T02:48:13.934Z"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">creator</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Tom Lee"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">parent</span>":<span class="hljs-value" style="color: #48b685;">{
        "<span class="hljs-attribute" style="color: #ef6155;">type</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"folder"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">id</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"10036454"</span></span>,
        "<span class="hljs-attribute" style="color: #ef6155;">name</span>":<span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"Pictures"</span>
    </span>}
</span>}
</code></pre>
<h4 id="e99499e8afaf-26" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">404 文件不存在</p></li>
</ul>
<h2 id="e58886e4baabe993bee68ea5e79bb8e585b3e68ea5e58fa3" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 40px; color: inherit; text-rendering: optimizelegibility; font-size: 31.5px;"><a href="id:sharelink" target="_blank" style="color: #0088cc; text-decoration: none;">分享链接相关接口</a></h2>
<h3 id="e4bf9de5ad98e69687e4bbb6e79a84e58886e4baabe993bee68ea5e4bfa1e681afe887b3e69c8de58aa1e7abaf" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:save_sharelink_to_server" target="_blank" style="color: #0088cc; text-decoration: none;">保存文件的分享链接信息至服务端</a></h3>
<h4 id="e68f8fe8bfb0-34" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">个人空间中的文件，客户端生成分享链接相关信息后，将信息保存到服务器端</p>
<h4 id="urle7bb93e69e84-34" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/files/{fileId}/sharelink</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong>  <em style="font-style: italic;">必选项</em>  文件ID</p></li>
</ul>
<h4 id="method-33" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT</code></p>
<h4 id="curl-34" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/files/FILE_ID/sharelink \
-<span class="ruby">d <span class="hljs-string" style="color: #48b685;">'password=PASSWORD&amp;cipherTextKey=CIPHER_TEXT_KEY'</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">X</span> <span class="hljs-constant" style="color: #ef6155;">PUT</span>
</span></code></pre>
<h4 id="request20body-8" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">Form data</p>
<pre style="word-wrap: break-word;"><code class="hljs puppet" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;"><span class="hljs-literal" style="color: #f99b15;">password</span>=<span class="hljs-keyword" style="color: #815ba4;">{</span><span class="hljs-literal" style="color: #f99b15;">password</span><span class="hljs-keyword" style="color: #815ba4;">}</span>&amp;cipherTextKey=<span class="hljs-keyword" style="color: #815ba4;">{</span>ciphertextkey<span class="hljs-keyword" style="color: #815ba4;">}</span>
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">password</strong>    <em style="font-style: italic;">required</em>  链接密码（需使用用户自己的私钥对密码进行aes256进行加密，并转换成hex string）</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">cipherTextKey</strong>  <em style="font-style: italic;">required</em>  使用明文的链接密码对文件的存储密钥进行加密后的密文存储密钥，需转换成hex string</p></li>
</ul>
<h4 id="e8bf94e59b9e-34" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<pre style="word-wrap: break-word;"><code class="hljs clojure" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;"><span class="hljs-collection">{
     id<span class="hljs-string" style="color: #48b685;">":"</span><span class="hljs-collection">{id}</span><span class="hljs-string" style="color: #48b685;">",
     "</span>shareLink<span class="hljs-string" style="color: #48b685;">":"</span><span class="hljs-collection">{sharelink}</span><span class="hljs-string" style="color: #48b685;">",
     "</span>password<span class="hljs-string" style="color: #48b685;">":"</span><span class="hljs-collection">{password}</span><span class="hljs-string" style="color: #48b685;">",
     "</span>expireTime<span class="hljs-string" style="color: #48b685;">":{expireTime},
     "</span>state<span class="hljs-string" style="color: #48b685;">":"</span><span class="hljs-collection">{state}</span><span class="hljs-string" style="color: #48b685;">"
}
</span></span></code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">id</strong> 链接id</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">shareLink</strong> 分享链接</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">password</strong> 链接密文密码</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">expireTime</strong> 链接过期时间，如果没有设置则为0</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">state</strong> 链接状态，0为未分享，1为已分享</p></li>
</ul>
<h4 id="e99499e8afaf-27" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">返回的error message信息格式如下：</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">status</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">409</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">code</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">409</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">errorCode</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">10030</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">message</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"                     {"</span>id<span class="hljs-string" style="color: #48b685;">":60,"</span>shareLink<span class="hljs-string" style="color: #48b685;">":"</span>https://e.surdoc.net/lnk/CN1QSY<span class="hljs-string" style="color: #48b685;">","</span>password<span class="hljs-string" style="color: #48b685;">":"</span>fsfsfsfsf<span class="hljs-string" style="color: #48b685;">","</span>expireTime<span class="hljs-string" style="color: #48b685;">":0,"</span>state<span class="hljs-string" style="color: #48b685;">":1}"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">moreInfoUrl</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"mailto:developers@surdoc.com"</span>
</span>}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">409: 说明该文件已经生成过分享链接了</p></li>
</ul>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">注：在error message中的message属性中会返回该文件已经生成的分享链接的json字符串。</p>
<h3 id="e4bf9de5ad98e585b1e4baabe79baee5bd95e4b8ade69687e4bbb6e79a84e58886e4baabe993bee68ea5e4bfa1e681afe887b3e69c8de58aa1e7abaf" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:save_sharelink_in_share_folder_to_server" target="_blank" style="color: #0088cc; text-decoration: none;">保存共享目录中文件的分享链接信息至服务端</a></h3>
<h4 id="e68f8fe8bfb0-35" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">共享文件夹中的文件，客户端生成分享链接相关信息后，将信息保存到服务器端</p>
<h4 id="urle7bb93e69e84-35" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/sharefolders/files/{fileId}/sharelink?shareFolderId={shareFolderId}</code></p>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">fileId</strong>  <em style="font-style: italic;">必选项</em>  文件ID</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">shareFolderId</strong> <em style="font-style: italic;">必选项</em> 文件所在共享目录ID</p></li>
</ul>
<h4 id="method-34" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT</code></p>
<h4 id="curl-35" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/sharefolders/files/FILE_ID/sharelink?shareFolderID=SHARE_FOLDER_ID \
-<span class="ruby">d <span class="hljs-string" style="color: #48b685;">'password=PASSWORD&amp;cipherTextKey=CIPHER_TEXT_KEY'</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">X</span> <span class="hljs-constant" style="color: #ef6155;">PUT</span>
</span></code></pre>
<h4 id="request20body-9" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">Form data</p>
<pre style="word-wrap: break-word;"><code class="hljs puppet" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;"><span class="hljs-literal" style="color: #f99b15;">password</span>=<span class="hljs-literal" style="color: #f99b15;">password</span>&amp;cipherTextKey=<span class="hljs-keyword" style="color: #815ba4;">{</span>ciphertextkey<span class="hljs-keyword" style="color: #815ba4;">}</span>
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">password</strong>    <em style="font-style: italic;">required</em>  链接密码（需使用用户自己的私钥对密码进行aes256进行加密，并转换成hex string）</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">cipherTextKey</strong>  <em style="font-style: italic;">required</em>  使用明文的链接密码对文件的存储密钥进行加密后的密文存储密钥，需转换成hex string</p></li>
</ul>
<h4 id="e8bf94e59b9e-35" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<pre style="word-wrap: break-word;"><code class="hljs clojure" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;"><span class="hljs-collection">{
     id<span class="hljs-string" style="color: #48b685;">":"</span><span class="hljs-collection">{id}</span><span class="hljs-string" style="color: #48b685;">",
     "</span>shareLink<span class="hljs-string" style="color: #48b685;">":"</span><span class="hljs-collection">{sharelink}</span><span class="hljs-string" style="color: #48b685;">",
     "</span>password<span class="hljs-string" style="color: #48b685;">":"</span><span class="hljs-collection">{password}</span><span class="hljs-string" style="color: #48b685;">",
     "</span>expireTime<span class="hljs-string" style="color: #48b685;">":{expireTime},
     "</span>state<span class="hljs-string" style="color: #48b685;">":"</span><span class="hljs-collection">{state}</span><span class="hljs-string" style="color: #48b685;">"
}
</span></span></code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">id</strong> 链接id</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">shareLink</strong> 分享链接</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">password</strong> 链接密文密码</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">expireTime</strong> 链接过期时间，如果没有设置则为0</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">state</strong> 链接状态，0为未分享，1为已分享</p></li>
</ul>
<h4 id="e99499e8afaf-28" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">错误</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">返回的error message信息格式如下：</p>
<pre style="word-wrap: break-word;"><code class="hljs json" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    "<span class="hljs-attribute" style="color: #ef6155;">status</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">409</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">code</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">409</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">errorCode</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-number" style="color: #f99b15;">10030</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">message</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"                     {"</span>id<span class="hljs-string" style="color: #48b685;">":60,"</span>shareLink<span class="hljs-string" style="color: #48b685;">":"</span>https://e.surdoc.net/lnk/CN1QSY<span class="hljs-string" style="color: #48b685;">","</span>password<span class="hljs-string" style="color: #48b685;">":"</span>fsfsfsfsf<span class="hljs-string" style="color: #48b685;">","</span>expireTime<span class="hljs-string" style="color: #48b685;">":0,"</span>state<span class="hljs-string" style="color: #48b685;">":1}"</span></span>,
    "<span class="hljs-attribute" style="color: #ef6155;">moreInfoUrl</span>": <span class="hljs-value" style="color: #48b685;"><span class="hljs-string" style="color: #48b685;">"mailto:developers@surdoc.com"</span>
</span>}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">409: 说明该文件已经生成过分享链接了</p></li>
</ul>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">注：在error message中的message属性中会返回该文件已经生成的分享链接的json字符串。</p>
<h3 id="e58886e4baabe993bee68ea5e8aebee7bdae" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:sharelink_settings" target="_blank" style="color: #0088cc; text-decoration: none;">分享链接设置</a></h3>
<h4 id="e68f8fe8bfb0-36" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">分享链接设置，主要用于设置到期时间以及分享状态</p>
<h4 id="urle7bb93e69e84-36" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/lnk/settings</code></p>
<h4 id="method-35" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">PUT</code></p>
<h4 id="curl-36" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/lnk/settings \
-<span class="ruby">d <span class="hljs-string" style="color: #48b685;">'{"id":ID, "expireTime":EXPIRE_TIME, "state“:STATE}'</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">X</span> <span class="hljs-constant" style="color: #ef6155;">PUT</span>
</span></code></pre>
<h4 id="request20body-10" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">JSON data</p>
<pre style="word-wrap: break-word;"><code class="hljs pf" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">{
    <span class="hljs-string" style="color: #48b685;">"id"</span>:<span class="hljs-string" style="color: #48b685;">"{id}"</span>,
    <span class="hljs-string" style="color: #48b685;">"expireTime"</span>:{expireTime},
    <span class="hljs-string" style="color: #48b685;">"state"</span>:{<span class="hljs-keyword" style="color: #815ba4;">state</span>}
}
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">id</strong>    <em style="font-style: italic;">required</em>  链接id</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">expireTime</strong>  <em style="font-style: italic;">required</em> 过期时间的毫秒数，如果没有该属性，则服务器端不会更新过期时间</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">state</strong> <em style="font-style: italic;">required</em> 整数（0 or 1）如果不设置该属性，则服务器端不会设置链接状态</p></li>
</ul>
<h4 id="e8bf94e59b9e-36" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">成功则返回204状态码，没有响应体</p>
<h3 id="e58f91e98081e58886e4baabe993bee68ea5e79a84e982aee4bbb6" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 1.1; color: inherit; text-rendering: optimizelegibility; font-size: 24.5px;"><a href="id:send_sharelink_email" target="_blank" style="color: #0088cc; text-decoration: none;">发送分享链接的邮件</a></h3>
<h4 id="e68f8fe8bfb0-37" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">描述</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">将分享链接通过邮件发送给对方</p>
<h4 id="urle7bb93e69e84-37" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">URL结构</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code> <code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">https://server/api/v1/lnk/sendTo</code></p>
<h4 id="method-36" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">METHOD</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><code style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #2C3E50; font-size: 90%; padding-top: 2px; padding-right: 4px; padding-bottom: 2px; padding-left: 4px;">POST</code></p>
<h4 id="curl-37" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">curl</h4>
<pre style="word-wrap: break-word;"><code class="hljs haml" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;">curl https://server/api/v1/lnk/settings \
-<span class="ruby">d <span class="hljs-string" style="color: #48b685;">'{"id":ID, "expireTime":EXPIRE_TIME, "state“:STATE}'</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">H</span> <span class="hljs-string" style="color: #48b685;">"Authorization: Bearer ACCESS_TOKEN"</span> \
</span>-<span class="ruby"><span class="hljs-constant" style="color: #ef6155;">X</span> <span class="hljs-constant" style="color: #ef6155;">POST</span>
</span></code></pre>
<h4 id="request20body-11" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">Request Body</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">Form data</p>
<pre style="word-wrap: break-word;"><code class="hljs protobuf" style="background-color: #D6DBDF; border: 0; border-radius: 4px; color: #4f424c; font-size: 90%; padding-top: 0.5em; padding-right: 0.5em; padding-bottom: 0.5em; padding-left: 0.5em; display: block; overflow-x: auto; background: #e7e9db; -webkit-text-size-adjust: none;"><span class="hljs-class"><span class="hljs-keyword" style="color: #815ba4;">message</span>={</span><span class="hljs-class"><span class="hljs-keyword" style="color: #815ba4;">message</span>}&amp;<span class="hljs-title" style="color: #776e71;">receivers</span>[]=</span>{receiver1}&amp;receivers[]={receiver2}...
</code></pre>
<ul style="padding-top: 0; padding-right: 0; padding-bottom: 0; padding-left: 0; margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 25px;">
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">receivers</strong>    <em style="font-style: italic;">required</em>  邮件接受者，可设置多个</p></li>
<li><p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;"><strong style="font-weight: bold;">message</strong>  <em style="font-style: italic;">required</em> 要发送的邮件信息</p></li>
</ul>
<h4 id="e8bf94e59b9e-37" style="margin-top: 0.5em; margin-right: 0; margin-bottom: 0.5em; margin-left: 0; font-family: inherit; font-weight: 500; line-height: 20px; color: inherit; text-rendering: optimizelegibility; font-size: 17.5px;">返回</h4>
<p style="margin-top: 0; margin-right: 0; margin-bottom: 10px; margin-left: 0; line-height: 1.8em;">成功则返回204状态码，没有相应体</p>
</div>
</body>
</div></div>
</body></html>

